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不 少 学 习 nC/OS 的 读者 都 会 面临 一 种 乾 炊 ， 就 是 想 阅 读 hC/OS-III 的 源码 却 因为 资料 过 少 而 转 去 阅读 C/OS-II 的 源码 。 如 果 拿 着 nC/OS- 了 I 的 书 来 
理解 MC/OS-III 的 源码 ， 多 半 也 会 感到 淡淡 的 忧伤 ， 因 为 两 者 的 源码 相差 实在 太 大 。 为 了 更 加 规范 ，hC/OS-III 不 仅 对 很 多 变量 进行 了 修改 ， 而 且 在 很 
多 处 理 问题 的 机 制 上 也 有 很 大 的 突破 ， 比 如 引入 时 间 片 、 取 消 任务 数量 限制 等 ， 如 下 表 所 示 。 实 际 上 ，2009 年 就 已 推出 LC/OS-ITI,， 但 是 直到 现在 市 
面 上 hC/OS-II 的 资料 依然 很 少 ， 介 绍 源码 的 资料 更 是 少 之 又 少 ， 即 使 官方 手册 也 只 是 介绍 使 用 方法 而 不 是 介绍 原理 。 笔 者 在 阅读 源码 的 过 程 中 也 遇 
到 了 一 些 问题 ， 要 是 有 足够 的 资料 ， 很 多 疑惑 就 能 够 比较 快 地 得 到 解答 。 所 以 ， 笔 者 在 阅读 源码 时 将 hC/OS-III 的 原理 、 应 用 等 记录 下 来 ， 希 望 能 为 
对 nC/OS-II 或 者 谱 入 式 实时 操作 系统 有 兴趣 的 读者 提供 帮助 。 
































各 版 本 hC/OS 的 主要 区 别 
特征 u C/OS-II u C/OS-Il 

推出 年 份 1998 2009 

B 夭 有 有 

是 否 开放 源码 是 是 
抢占 式 多 任务 处 理 是 是 
支持 最 多 的 任务 数量 255 无 限 

每 个 优先 级 的 任务 数 1 无 限 

是 否 支持 时 间 片 轮转 调度 否 是 

信号 量 有 有 

互 斥 信和 号 量 有 有 (可 柑 套 ) 
时 间 标 志 有 有 

邮箱 有 没有 (不 需要 ) 
队列 有 有 

固定 大 小 的 内 存 管理 这 有 有 

给 任务 发 送 消息 不 需 消息 队列 香 号 

软件 定时 器 是 是 

任务 挂 起 /恢复 是 是 (可 柑 套 ) 
死 锁 预 防 是 中 



































续 
特征 u C/OS h C/OS-ll h C/OS-Ill 

可 裁剪 是 是 是 

ROM 空间 大 小 3K ~ 8K 6K ~ 26K 6K ~ 24K 

RAM 空间 大 小 1K+ 1K+ 1K+ 

可 固化 是 是 是 

运行 时 间 配 置 是 是 是 

编译 时 间 配 置 是 是 是 

为 每 个 内 核对 象 分 配 名 字 从 是 是 

等 待 多 个 内 核对 象 从 是 是 

任务 寄存 器 奉 是 是 

内 柑 的 性 能 测试 奉 有 限 的 大 量 的 

用 户 定 义 钧 子 了 清关 奉 是 是 

捕获 任务 返回 得 否 是 

在 任务 中 处 理 心跳 个 是 是 

服务 数目 大 约 20 大 约 90 大 约 70 


笔者 认为 ， 阅 读 hC/OS-III 源 码 的 主要 理由 如 下 。 
1) 查看 优秀 的 源码 可 以 让 自己 的 编程 技巧 更 完善 ，nC/OS-III 源 码 的 风格 比较 好 ， 有 借鉴 意义 。 
2) 了 解 嵌 入 式 内 核 的 一 些 “ 内 幕 ”， 如 在 多 个 任务 中 从 一 个 任务 向 另 一 个 任务 发 送 消息 的 机 制 ， 这 让 我 很 好 奇 ! 


3) 学 习 hC/OS-IHI 源 码 的 过 程 也 可 以 作为 一 个 学 习 数据 结构 的 机 会 。hC/OS-II 涉 及 的 数据 结构 主要 是 线性 表 ， 源 码 中 的 很 多 数据 结构 都 设计 得 


4) 更 好 地 利用 LC/OS-III 做 开发 工作 。hC/OS 官 方 有 这 么 一 和 句 话 : “熟悉 了 hC/OS-IIT 这 样 的 实时 系统 多 任务 内 核 后 ， 读 者 将 不 会 再 回 到 传统 的 前 
后 台 系 统 的 设计 方法 中 去 。” 笔者 觉得 这 必须 建立 在 你 真正 懂 hC/OS 的 基础 上 。hC/OS 有 时 会 出 现 莫名 的 问题 ， 这 时 就 会 令 人 感到 很 头痛 。 当 然 ， 这 
主要 跟 使 用 者 配置 HC/OS 出 错 或 者 错误 使 用 某 些 系统 函数 有 关 ， 这 也 是 强调 要 在 会 用 的 基础 上 学 习 hC/OS 的 原因 。 另 外 ， 网 络 协议 LwIP、 蓝 牙 协 议 等 
应 用 也 都 结合 了 嵌入 式 实 时 操作 系统 。 如 果 已 经 学 习 过 嵌入 式 操 作 系统 ， 则 会 对 这 些 知识 有 更 好 的 掌握 。 也 许 在 查找 问题 的 过 程 中 ， 你 还 能 帮 hC/OS 
找到 几 个 bug， 欢 迎 大 家 一 起 来 “找茬 ”。 





本 书 与 其 他 书籍 的 编排 方式 不 一 样 : 其 他 书籍 是 按照 官方 文件 的 框架 或 者 组 件 的 方式 编排 的 ; 本 书 更 强调 循序 渐进 ， 并 结合 了 笔者 在 阅读 
hC/OS-III 源 码 过 程 中 的 一 些 想 法 。 比 如 一 个 结构 体 变量 可 能 会 有 多 个 元 素 ， 工 具 书 一 般 会 把 它们 放 在 一 起 讲解 ， 而 本 书 为 了 易于 读者 更 好 地 理解 ， 
只 在 某 些 源码 涉及 这 个 元 素 时 才 会 介绍 其 作用 和 含义 。 如 果 你 有 时 要 将 本 书 当 作 工 具 书 来 查询 ， 则 可 结合 这 些 相关 内 容 涉 及 的 源码 进行 查找 。 





在 数据 结构 方面 ， 笔 者 会 通过 很 多 自己 制作 的 图 片 来 介绍 数据 结构 之 间 的 关系 ， 以 便 大 家 更 好 地 理解 LC/OS-III 中 的 数据 结构 。 事 实 上 ， 这 是 一 
种 非常 好 的 理解 方式 。 


本 书 是 基于 hnC/OS 的 V3.02.00 版 本 的 源码 编写 而 成 的 。 另 外 ， 为 了 让 大 家 更 好 地 理解 MC/OS-III， 本 书 基于 市 面 上 流行 的 STM32 野 火 开 发 板 ISO-V2 
编写 例 程 ， 该 开发 板 使 用 的 芯片 是 STM32F103ZET6， 该 芯片 是 基于 Cortex-M3 内 核 的 。 本 书 例 程 使 用 的 IDE 是 4.72.10.0 版 本 的 MDK。 


本 书 的 读者 定位 是 那些 不 满足 于 停留 在 使 用 嵌入 式 系统 层面 上 ， 而 是 想 深入 理解 嵌入 式 系统 工作 原理 的 学 生 、 老 师 或 者 技术 人 员 。 因 此 ， 对 读者 
的 要 求 主 要 是 有 使 用 hC/OS-II 的 经 验 ， 这 样 会 对 hC/V/OS-II 有 所 把 握 ; 当然 ， 也 可 以 边 阅 读本 书 边 使 用 hC/OS-II， 这 样 看 书 就 不 会 被 动 。 另 外 ， 要 对 
嵌入 式 系统 的 具体 工作 原理 有 比较 浓厚 的 兴趣 ， 就 像 笔者 使 用 hMC/OS-II 一 样 ， 一 直 想 研究 清楚 它 内 部 的 原理 ， 于 是 浓厚 的 兴趣 帮 笔 者 在 阅读 hC/OS- 
III 源 码 的 路 上 克服 了 很 多 困难 。 据 说 hC/OS-IHI 代 码 量 有 三 四 万 行 ( 网 上 流传 ， 未 经 考证 ) ， 要 想 真正 了 解 MC/OS-II 的 运行 机 制 ， 就 更 需要 兴趣 。 当 
然 ， 对 数据 结构 和 Cortex-M3 内 核 比较 熟悉 的 读者 也 会 更 好 地 理解 本 书 。 建 议 读 者 在 阅读 本 书 的 时 候 对 上 述 的 数据 结构 和 Cortex-M3 内 核 进行 一 定 的 了 
解 ， 或 者 边 读 本 书 边 学 习 这 两 方面 的 内 容 。 





希望 读者 先 看 书 中 给 出 的 程序 ， 加 些 自己 的 注解 ， 如 果 不 懂 再 看 书 中 讲解 源码 的 文字 ， 这 样 可 以 做 到 独立 思考 。 本 书 比 较 适合 采用 这 种 阅读 方 
式 ， 因 为 本 书 在 解析 菜 个 函数 源码 时 会 将 相关 知识 焰 合 起 来 ， 而 不 是 从 头 到 尾 逐 行 讲解 。 本 书 也 用 了 一 定 的 篇 幅 收 纳 介 绍 到 的 大 部 分 代码 ， 目 的 是 让 





读者 真正 结合 源码 进行 理解 ， 而 不 是 纸上谈兵 。 然 而 ， 这 对 读者 提出 了 更 高 的 要 求 。 与 阅读 那些 纯粹 讲解 诬 入 式 操 作 系 统 原理 的 书 相 比 ， 阅 读本 书 或 
许 有 些 困难 ， 但 是 如 果 坚 持 下 来 ， 相 信 收 获 也 会 更 多 。 理 解 源码 时 要 抓 住 其 本 质 。 和 希望 本 书 让 你 学 到 的 不 只 是 hC/OS-III， 而 是 谋 入 式 实时 操作 系 
统 。 
致谢 

首先 感谢 野火 科技 有 限 公 司 的 创始 人 刘 火 良 ， 笔 者 在 他 的 鼓励 和 指导 下 编写 了 本 书 。 

其 次 感谢 审阅 本 书 的 张 浩 和 Ifteecoding， 他 们 不 仅 对 本 书 进行 了 详细 的 审阅 ， 还 提出 了 很 多 修改 意见 。 


接着 感谢 我 的 父母 及 我 的 好 朋友 。 请 允许 我 逐一 道 出 这 些 好 朋友 的 名 字 : 林 灿 杰 、 庄 培 钊 、 陈 佳 胸 、 潘 炜 键 、 杨 党 新 、 陈 德 兴 、 邹 秋 云 、 陈 映 
胸 、 郑 春 升 、 李 健雄 、 郭 心 如 、 吴 思 洁 等 ， 谢 谢 你 们 让 我 的 生命 更 加 丰富 多 彩 。 


感谢 本 书 的 策划 编辑 张国强 先生 ， 是 他 促成 了 本 书 的 出 版 ， 同 时 提出 了 宝贵 的 写作 建议 ， 并 对 书稿 进行 了 仔细 审阅 。 
感谢 《Cortex-M3 权 威 指南 》 的 译 者 宋 岩 和 《大 话 数据 结构 》 的 作者 程 杰 ， 他 们 给 我 提供 了 学 习 Cortex-M3 内 核 和 数据 结构 的 非常 好 的 资料 。 


由 于 本 书 涉及 的 知识 面 广 ， 加 上 时 间 仓 促 ， 以 及 笔者 的 水 平 有 限 ， 所 以 政 漏 之 处 在 所 难免 ， 在 此 咏 请 专家 和 读者 批评 指正 ， 可 以 发 送 邮 件 到 ucos- 
过 (qq.com 与 我 进行 交流 ， 或 者 到 聊 龙 BBS (www.bbsxiaolong.com) 发 帖 交 流 。 本 书 所 有 例 程 及 相关 资料 都 可 以 在 论坛 的 LC/OS-III 版 块 中 下 载 ， 还 可 
加 入 QQ 群 (223501362) 进行 交流 。 


感谢 购买 本 书 的 你 们 ， 让 我 有 机 会 认真 地 做 好 一 件 事情 ， 也 愿 此 书 能 在 你 解读 4C/OS-III 源 码 的 路 上 带 来 帮助 。 


李 悦 城 ”野火 


第 1 章 ”实时 操作 系统 及 uC/OS-lll 简 介 


本 章 首先 介绍 从 单片机 应 用 程序 框架 引入 的 实时 操作 系统 ， 接 着 介绍 怎么 学 习 hC/OS- 吊 源码， 然后 简单 介绍 hC/OSs- 吊 的 文件 结构 和 数据 结构 、 
任务 、 内 核对 象 、 常 见 代码 段 等 ， 为 后 面 的 章节 做 铺垫 。 有 些 概 念 刚 开始 接触 可 能 不 是 很 容易 理解 ， 可 以 先 忽略 它们 继续 阅读 下 去 ， 后 面 就 会 有 “ 柳 
六 花 明 又 一 村 ”的 感觉 。 


1.1 单片机 应 用 程序 框架 


1.1.1 前 后 台 系 统 


在 单片机 应 用 程序 中 ， 最 常用 的 就 是 前 后 台 系 统 ， 通 常 由 一 个 大 循环 和 中 断 组 成 ， 大 循环 是 后 台 ， 中 断 是 前 台 。 前 后 台 系 统 的 程序 流程 比较 简 
单 ， 但 是 ， 当 发 片 处 理 的 事情 越 来 越 多 、 越 来 越 复杂 的 时 候 ， 前 后 台 系 统 并 不 能 保证 实时 性 。 这 在 一 些 协议 栈 等 实时 性 要 求 高 的 场合 是 不 允许 的 ， 这 
时 编写 程序 的 人 就 要 重新 设计 程序 框架 或 者 使 用 本 书 介绍 的 实时 操作 系统 帮忙 进行 合理 的 任务 调度 ， 让 紧急 的 事务 优先 执行 。 


顺序 执行 的 前 后 台 系统 的 程序 如 代码 清单 1-1 所 示 。 


代码 清单 1-1 前 后 台 系 统 程序 框架 





main() 
{ 
Peripheral Init(); // 外 设 初始 化 
while (1) 
{ 


} 
} 


process (); // 程序 主要 处 理 部 分 


除了 简单 的 顺序 执行 那样 的 前 后 台 系 统 程序 外 ， 还 可 以 采用 时 间 片 轮 询 法 加 以 改进 。 


时 间 片 轮 询 法 是 多 个 任务 以 一 定 的 频率 执行 ， 就 像 多 个 任务 一 起 无 干扰 地 执行 一 样 。 下 面 看 看 一 个 简单 的 时 间 片 轮 询 法 的 代码 框架 是 怎么 实现 
的 。 


本 次 介绍 使 用 时 间 片 轮 询 法 创建 多 个 任务 并 一 起 运行 ，LED1 任 务 每 500ms 转 换 一 次 状态 ，LED2 任 务 每 1s 转 换 一 次 状态 ，LED3 任 务 每 2s 转 换 一 次 
状态 ， 实 现 起 来 非常 简单 。 首先 看 看 main 函 数 的 流程 ， 时 间 片 轮 询 法 中 任务 的 编写 方式 如 代码 清单 1-2 所 示 ， 并 且 放 入 while (1) 循环 中 。 


代码 清单 1-2 ”任务 编写 方式 


01 if (Task delay[i]==0) 
02 { 

03 Task (i); 

04 Task Delay[i]=XXX; 
05 } 


Task_delay 是 一 个 数组 ， 有 多 少 个 任务 就 有 多 少 个 数组 元 素 ， 我 们 在 例 程 1-1 中 设置 为 3 个 ， 但 一 开始 数组 元 素 都 设置 为 0。 第 一 次 判断 肯定 会 进 
入 if 判 断 里 面 执 行 任务 Task (i) 的 代码 ， 执 行 完 这 个 任务 之 后 ，Task_Delay 由 变 成 了 XXXX。 这 里 假设 XXXX=1000， 下 次 判断 如 果 Task_Delay[ 不 为 
0， 就 不 会 执行 任务 Task (i) 。 如 果 使 用 一 个 定时 器 每 1ms 将 Task_Delay[i] 减 1， 那 么 在 1000ms 之 后 的 判断 条 件 又 成 立 了 ， 并 且 任 务 执行 的 间隔 是 
1000ms， 如 此 循环 往复 ， 就 可 以 让 任务 Task (i) 的 执行 频率 大 致 为 1Hz。 在 while (1) 这 个 循环 中 ， 还 可 以 创建 其 他 任务 ， 并 且 可 以 通过 设置 
Task_delay[j] 的 大 小 来 决定 任务 执行 的 频率 。 想 要 理解 好 上 面 的 内 容 ， 需 要 忽略 任务 运行 的 时 间 、 定 时 器 中 断 服务 程序 执行 的 时 间 。 只 要 不 在 任务 代 
码 里 添加 太 长 的 延 时 、 执 行 时 间 长 的 任务 ， 那 么 任务 的 执行 频率 跟 理 想 化 的 不 会 相差 太 远 ， 而 导致 前 后 台 系 统 实 时 性 差 的 也 正 是 这 些 原因 。 
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09 int main (void) 


OA 
OOOPODP 








10 { 

11 ”/*LED 灯 管 脚 的 配置 */ 

12 LED Config(); 

13 

14 ”/* 这 里 中 断 频率 配置 为 1000Hz*/ 
15 Interrupte Config (72000); 
16 

17 /* Infinite loop */ 

18 while (1) 

19 { 

20 if(Task Delay[0]==0) 
21 { 

22 LED1 TOGGLE; 

23 

24 Task Delay[0]=500; 
25 } 

26 

2 if (Task Delay[1]==0) 
28 { 

29 LED2 TOGGLE; 

30 

3 Task Delay[1]=1000; 
32 } 

33 

34 if (Task Delay[2]==0) 
35 { 

36 LED3 TOGGLE; 

37 

38 Task Delay[2]=2000; 
39 } 

40 } 

41 } 


前 面 介 绍 了 中 断 服务 程序 会 在 每 次 中 断 时 将 Task_delay 这 个 数组 的 所 有 元 素 执行 减 1 操作 。 接 下 来 看 看 咬 噶 定时 器 的 中 断 服 务 程 序 。 


Ql /玉米 类 火炎 火炎 类 火炎 炎炎 炎炎 炎炎 六 大火 太 炎炎 六 火炎 类 大 炎炎 大 关头 类 类 炎炎 类 类 类 类 类 大 类 关 大 六 类 类 六 炎 大 类 类 炎炎 大 类 关 炎炎 类 大 大大 炎炎 类 大 类 类 大 大大 大 大大 
02 * 函数 名 称 : Interrupte Handler 

03 * 输入 参数 : void 

04 * 输出 参数 : void 

05 * 功 能 : 时 间 片 轮 询 法 中 定时 器 的 中 断 服务 程序 

06 * 作 者 : 戏 龙 LyCc 

07 * 举 例 : lms，1 次 中 断 


08 类 太太 炎炎 类 炎 炎 太 交大 大大 大大 大 类 大大 类 大 类 大 六 炎炎 类 大 大 大 大 类 类 类 大 大大 类 大大 大 类 大 类 磋 大 类 大 大 大 大 类 类 大 大 大 大 大 类 大 大 大 大大 大 大 大 大 大 大 大 大 大 大 大 了/ 
09 void Interrupte Handler (void) 

4 人 4 

11 unsigned char i; 

12 for (i=0;i<NumOfTask; i++) 


14 if (Task Delay[i]) 


16 Task Delay[i]--; 
} 


中 断 服务 程序 其 实 很 容易 理解 ， 在 for 循 环 中 将 NumOfTask 个 任务 对 应 于 数组 Task_Delay 中 的 元 素 都 减 1， 但 是 在 减 1 之 前 要 判断 元 素 是 否 为 0， 
如 果 为 0 就 停止 减 1 操作 。 通 过 上 述 代码 ， 就 简单 地 实现 了 时 间 片 轮 询 法 ， 可 以 在 此 基础 上 任意 地 添加 任务 。 想 对 一 般 程 序 来 说 ， 这 段 代码 的 实时 性 比 
抢占 式 实时 操作 系统 差 。 宏 观 上 ， 时 间 片 轮 询 法 的 各 个 任务 也 不 会 互相 影响 ,好似 多 个 任务 一 起 相安 无 事 地 在 进行 着 ,实际 上 ， 若 任务 很 多 或 者 任务 
执行 的 时 间 比 较 长 ， 还 是 会 影响 任务 的 执行 频率 。 比 如 其 中 一 个 任务 霸占 CPU 的 时 间 足 1s， 而 其 他 任务 在 这 1s 内 完全 是 不 执行 的 ， 即 执行 频率 变 为 
0， 这 在 某 些 系统 中 是 不 允许 的 。 


1.2 如何 使 用 和 学 习 HhC/OSs- 员 源码 


好 的 学 习 方法 事半功倍 。 本 节 将 结合 笔者 学 习 hC/OS- 咱 源码 的 经 验 来 介绍 下 如 何 学 习 hC/OS- 咱 源码。 
1 查阅 文档 ， 动 手 实践 


在 学 习 源 码 之 前 ， 还 是 先 让 自己 对 nC/OS-lll 有 个 整体 的 感知 ， 这 是 本 书 对 读者 的 最 低 要 求 。 一 般 来 说 ， 开 发 板 例 程 会 提供 uC/OS- 川 直接 可 用 的 
程序 ， 你 可 以 在 开发 板 例 程 的 基础 上 照 猫 画 虎 写 几 个 任务 并 运行 之 。 或 许 你 不 知道 任务 的 奇怪 参数 是 什么 意思 ， 但 这 也 丝毫 不 会 影响 你 编写 简单 的 程 
序 。 创 建 完 任务 后 最 好 还 使 用 一 些 内 核对 象 ， 如 信号 量 、 消 息 队列 、 定 时 器 等 ， 这 些 也 可 以 照 猫 画 虎 ， 但 也 可 以 自己 照 着 hC/OS- 吊 的 手册 和 函数 注 
释 来 使 用 这 些 内 核对 象 。 下 面 举 例 说 明 笔 者 一 开始 是 怎么 使 用 定时 器 的 。 笔 者 刚 开始 接触 XC/OS-lll， 是 在 做 一 个 比较 大 的 项 目 ， 需 要 用 到 多 个 定时 
器 ， 了 解 用 硬件 定时 器 太 麻 烦 ， 而 uC/OS-lll 能 提供 软件 定时 器 。 首 先 到 定时 器 的 文件 中 看 看 有 什么 函数 可 以 调用 ， 如 图 1-1 所 示 。 











由 - os stat.c 
由 - 固 ostask.c 
由 - 加 os tick.c 





et 而 5 Thrclr (QS_TMR *p_tmr) 
入 OS TmrDbgListAdd (OS TMR *p_tmr) 
起 OS_TmrDbgListRemove (OS_TMR *p tmn 
一 向 OS_TmrInit (OS_ERR *p_err) 
忆 昌 DOS Tmrunk (OS_TMR *p_tmr, OS _OPT cpl | 
人 OS TmrResetpeak (void) : 
: ~ 遇 口 S_TmrTask (vod *p_arg) 
: 遇 OS TmrUnlink (OS_TMR *p tmnm 
一 有 徇 OSTmrCreate (OS_TMR *p_ tmr CPU_CHAF 
入 OSTmrDel (OS_TMR *p_tmr, OS_ERR *p_er 
~ 昌 OSTmrRemainGet (OS_TMR *p tmr OS EF 
和合 OSTmrStart (OS_TMR *p_tmr, OS_ERR *p,, 
二 OSTmrStateGet (OS_TMR *p tmr, OS_ERR 
: Le 起 OSTmrStop (OS$_TMR *p tmr, ODS OPT opit 
| 一 O5 Var.c 
自 - 加 stm32{f10x adc.c 
由 -加 stm32f10x bkp.c 
4 
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图 1-1 OSTmrCreate 哆 数 的 位 置 


在 函数 列表 中 可 看 到 一 个 ODSTmrCreate 函 数 ( 见 图 1-1) ， 无 论 是 变量 名 、 宏 定义 还 是 函数 名 ，NC/OS- 川 命令 都 十 分 规范 ， 让 人 很 容易 见 名 知 
意 ， 而 通过 OSTmrCreate 这 个 函数 名 称 就 可 以 知道 这 是 一 个 创建 定时 器 的 函数 。 到 底 要 怎么 调用 这 个 函数 呢 ? HhC/OS- 咱 函数 注释 得 非常 详细 ， 如 图 
1-2 所 示 。 


找到 OsTmrCreate 函 数 的 定义 处 ， 函 数 前 面 就 有 详细 的 注释 。 通 过 注释 可 以 知道 函数 的 用 途 ， 应 该 输入 什么 样 的 参数 ， 会 有 什么 返回 值 ， 有 什 
么 注意 事项 等 ， 可 以 根据 这 些 提示 来 调用 函数 。 注 释 不 可 能 面面俱到 ， 读 完 注释 后 ， 在 调用 过 程 中 可 能 还 会 有 很 多 不 能 理解 的 地 方 ， 比 如 定时 的 单位 
是 什么 。 这 要 靠 你 对 hC/OS- 员 的 理解 ， 可 以 查阅 一 些 相关 书籍 ， 本 书 也 会 讲解 HC/OS- 员 部 分 函数 的 使 用 。 为 什么 是 部 分 呢 》 在 看 源码 注释 的 时 候 ， 
我 们 会 看 到 一 些 函 数 的 注释 中 包含 这 样 的 注释 : 





* Note (S) : 1) This function is INTERNAL to uC/OS-III and your application 
MUST NOT call it. 

















49 <^ 

50 | /*$PAGE*/ 国 

5 了 日 /> 国 

面 2 | 闵 冰冰 闵 冰冰 冰冰 冰冰 冰冰 冰冰 冰冰 冰冰 冰冰 冰冰 冰冰 冰冰 冰冰 玉 冰冰 六 冰冰 冰冰 冰冰 冰冰 冰冰 冰冰 来 冰冰 冰冰 六 冰冰 冰冰 冰冰 冰冰 冰冰 米 冰 六 冰冰 冰冰 冰冰 冰冰 冰冰 六 冰冰 玉 冰 冰冰 冰冰 冰冰 冰冰 冰冰 冰冰 冰冰 来 六 冰冰 冰冰 冰冰 水 冰冰 冰冰 冰冰 冰冰 冰冰 冰冰 六 冰冰 六 

53 | * CREATE A TIMER 

54 | * 

55 | * Description: This function is called by your application code to create a timer. 

56 | * 

57 |* Arguments : p_tmr Is a pointer to a timer control block 

58 |* 

59 |* p_name Is a pointer to an ASCII string that is used to name the timer. Names are useful for 

60 | 六 debugging 

61 |* 

62 |* dly Initial delay 

63 |* If the timer is configured for ONE-SHOT mode, this is the timeout used 

64 |+* If the timer is configured for PERIODIC mode, this is the first timeout to wait for 

65 | 六 befdre the timer starts entering periodic mode 

66 |* 

67 | 六 period The “period ”being repeated for the timer. 

68 |* If you specified "0S OPT TMR PERIODIC’ as an option, when the timer expires, it will 

69 |* automatically restart with the same period. 

70 |* 

71 |* opt Specifies either: 

T2 |* 

13 |* 0S_OPT_TMR_ONE_SHOT The timer counts down only once 

74 |* OS_OPT_TMR_PERIODIC The timer counts down and then reloads itself 

75 | 

76 | p_callback Is a pointer to a callback function that will be called when the timer expires. The 

T7 |* callback function must be declared as follows: S 
| 











图 1-2 ”OSTmrCreate 吕 数 注释 


如 果 函 数 的 注释 中 有 这 样 的 注释 ,说明 在 使 用 uC/OS-lll 的 时 候 不 能 调用 他 们 ， 这 些 函 数 一 般 都 是 内 核 操 作 相 关 的 ， 如 果 随便 调用 可 能 导致 意 想 
不 到 的 错误 ,最 好 还 是 不 要 调用 他 们 ， 所 以 本 书 也 就 不 讲解 这 些 函 数 是 怎么 使 用 的 。 代 码 清单 1-3 展 示 了 怎么 调用 函数 OSTmrCreate。 


代码 清单 1-3 ”函数 OSTmrCreate 的 调用 





1 OSTmrCreate ((OS_ TMR *) &TrmrOfKeyv 

2 (CPU_CHAR *) "TmrOfKey", 

3 (OS_TICK ) 0v 

4 (OS_ TICK yl; 

5 (OS_OPT )OS_OPT TMR PERIODIC, 
6 (OS TMR CALLBACK PTR )cbTimerOfKey, 

7 (void 光 你 

8 (OS_ERR *) &err); 


本 书 是 在 笔者 阅读 hC/OS- 吊 源码 和 使 用 hC/OSs- 员 的 基础 上 进行 介绍 的 。 只 翻译 注释 来 讲解 每 个 函数 怎么 使 用 是 没有 多 少 意 义 的 。 我 们 在 解析 每 
个 源码 之 前 必须 先 讲解 怎么 使 用 函数 。 看 函数 源码 解析 的 时 候 最 好 先 按照 本 书 的 编排 方式 看 看 函数 是 怎么 使 用 的 ， 函 数 的 使 用 也 可 以 看 成 是 源码 解析 
的 一 部 分 ， 因 为 函数 的 使 用 会 介绍 函数 的 功能 、 函 数 的 参数 等 ， 这 些 都 是 理解 函数 必 不 可 少 的 信息 。 


用 OSTmrCreate 创 建 完 定时 器 后 ， 定 时 器 是 否 就 可 以 运行 了 呢 ? 实践 证 明 还 是 不 可 以 。 当 时 笔者 接着 查看 了 定时 器 文件 的 函数 ， 又 看 到 另 一 个 
函数 OSTmrstart， 可 能 还 要 调用 这 个 函数 来 开启 定时 器 才能 运行 ， 如 图 1-3 所 示 。 这 样 调用 函数 之 后 发 现 定时 器 就 真 的 运行 了 。 


由 以 上 过 程 可 以 看 到 ， 调 用 hC/Os- 吊 函数 的 过 程 还 是 挺 方 便 的 。 调 用 函数 其 实 不 难 ， 但 要 结合 注释 或 者 一 些 书籍 的 讲解 才能 真正 用 好 这 些 函 
数 。 本 书 配套 了 每 个 内 核对 象 的 使 用 例 程 ， 注 释 也 十 分 详细 ， 跟 着 例 程 照 猫 画 虎 地 使 用 这 些 内 核对 象 也 是 一 种 不 错 的 选择 。 








或 许 有 人 会 想 ， 如 果 已 经 有 相应 移植 好 的 工程 ， 那 么 在 上 手 hC/OS- 咱 之 前 就 先进 行 移植 。 这 是 完全 没有 必要 的 ， 因 为 官方 帮 有 我 们 将 大 部 分 


HC/OS-lll 移 值 到 了 CPU 上 ， 加 上 移植 的 过 程 并 不 简单 ， 移 植 需 要 建立 在 对 CPU 内 核 和 HC/OS-lll 有 足够 理解 的 基础 上 。 本 书 将 移植 uC/OS-lll 放 在 最 
后 介绍 ， 也 可 以 说 是 因为 HC/OS- 吊 的 移植 是 最 难 的 。 






由 -加 os task.c 
由 -区 os tick,.c 
由 - 国 os time.c 







和 OSTmrclr (OS_TMR *p_tmr) 
: 电 OS_TmrDbgListAdd (OS_TMR *P tmn) 
: 遇 OS TmrDbgListRemove (OS_TMR *p_tmr) 
s we 遇 OS_TmrInit (OS_ERR *p_err) 
-- 遇 品 S_TmrLink (OS_TMR *p tmr ODS OPT opt) 
下 OS_TmrResetPeak (void) 
: 昌 OS_TmrTask (vold *p_arg) 
= OS_TmrUnlink (OS_TMR *p_tmr) | 
和 OSTmrCreate (OS_TMR *p tmr, CPU_CHAR * 
: — 遇 OSTmrDel (OS_TMR *p_tmr, OS$_ERR *p_ern| 三 
一 二 OSTmrRemainGet (OS_TMR *p tmr OS_ ERR 
. OSTmrStart (OS$_ TMR *p tmr, OS ERR * 
~ OSTmrStateGet (OS TMR *p_tmr, OEERRT 
Es 筷 OSsTmrstop (Oo_ TIMR *p tmr, OQ% QPT1 opt, M 
一 国 Os _ Var.c 
由 - 国 stm32fl10x adc.c 
由 -加 stm32f10x_bkp.c 
由 - 加 stm32f10x_can.c 
由 -加 stm32f10x cec.c 








由 -加 stm32f10x crc.c 
由 [本 stm32f10x dac.c 
Fl stm32f10 dhomcuc 
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图 1-3 ”OSTmrStart 吕 数 的 位 置 


2. 循 环 渐 近 ， 深 入 了 解 


以 上 介绍 了 怎么 用 好 HCV/OS-I 员 ， 接 下 来 介绍 怎么 深入 学 习 hC/OS- 吊 源码。 最 开始 编写 本 书 的 时 候 ， 笔 者 在 想 ，HC/OS- 吊 中 那么 多 内 容 究竟 应 
该 按照 什么 样 的 顺序 讲解 才 是 最 好 的 。 一 开始 最 好 挑 最 容易 的 ， 与 整个 HC/OS- 员 联系 最 少 的 那些 源码 进行 讲解 。 本 书 讲解 的 顺序 相对 来 说 是 比较 好 
的 。 所 以 ， 首 先 要 对 嵌入 式 操 作 系统 和 hC/OS- 员 有 一 个 大 致 的 了 解 。 接 着 了 解 比较 容易 的 时 钟 节拍 和 定时 器 、 多 值 信号 量 。 由 于 多 值 信号 量 跟 二 值 
言 号 量 、 消 息 队列 、 事 件 标志 联系 比较 紧密 ， 所 以 将 这 些 内 容 放 在 一 起 介绍 。 最 后 讲解 任务 切换 、 任 务 相关 等 内 容 。 每 学 习 一 个 内 核对 象 之 前 ， 最 好 
先 了 解 内 核对 象 的 数据 结构 。 


1.3 ”HC/OS-ll| 文 件 结构 简 介 


HC/OS-llI 文 件 将 按照 由 底层 到 上 层 的 排列 顺序 进行 整理 。 下 面 根据 图 1-4 中 的 序号 对 HC/OS-lll 的 文件 结构 进行 介绍 。 
@ 配 置 文件 。 通 过 配置 文件 定义 宏 的 值 就 可 以 轻易 地 裁剪 其 他 不 用 的 代码 。 

@ 应 用 程序 。 应 用 程序 包含 任务 的 定义 和 声明 ， 用 户主 要 编写 的 是 这 部 分 代码 。 

@hC/Os- 咱 与 CPU 无 关 代码 。 这 部 分 代码 与 CPU 无 关 ， 可 以 不 做 修改 移植 到 任何 CPU， 本 书 主要 讲解 这 部 分 代码 。 
@ 库 。 这 部 分 主要 是 底层 函数 库 ， 比 如 字符 串 的 一 些 常规 操作 、 一 些 通常 的 数学 计算 等 。 

HC/OS-lll 与 移植 相关 代码 ， 如 果 读 者 想 要 移植 uC/OS-lll 到 不 同 平台 上 ， 那 么 可 以 根据 CPU 来 修改 这 部 分 代码 。 


@HC/OS- 咱 与 CPU 相 关 代码 。 


@ 配 置 文件 
cpu_cfg.h> 定义 CPU 相关 指令 〈 计 算 前 导 0) 存在 与 否 、CPU_NAME、 时 间 截 、 关 中 断 时 间 测 量 等 CPU 相关 配置 
lib_cfg.h> 库 的 相关 配置 


os_cfg.h> 


系统 相关 代码 配置 ， 这 部 分 是 拓展 性 的 ， 比 如 可 以 配置 是 否 糊 总 定 时 器 等 内 核对 象 的 宏 


回应 用 程序 
app. c 了 任务 相关 代码 的 编写 


os_cfg_app.h->》 系统 相关 代码 配置 ， 这 部 分 是 必须 设置 的 ， 比 如 时 钟 节拍 频率 的 配置 






@@ pC/0S-III 与 CPU 无 关 代码 


os_cfg_app. c 访 系统 任务 的 配置 
os_type. h> 内 核对 象 的 数据 类 型 定义 
os_dbg. c> 和 调试 相关 的 数据 类 型 定义 、 及 相关 代码 
os_flag. c 了 事件 标志 组 相关 函数 
os_int. c 了 > 中断 延 迟 相关 函数 
os_mem. c 信 内存 分 区 相关 函数 

v os_msg. c 访 消息 相关 函数 
逐 os_mutex. c 人 二 值 信 号 量 相关 函数 
渐 os_pend_multi. c?> 等 待 多 个 内 核对 象 相关 函数 

机 os_prio. c 了 > 优先 级 相关 函数 

3 os_q. c 队 列 相关 函数 
层 os_sem. c 人 多 值 信号 楼 相关 函数 
os_stat. c 防 统计 信息 相关 函数 
os_task. c 了 任务 相关 函数 
os_tick. c 字 时 钟 节拍 相关 函数 
os_time. c 字 时 间 管 理 相 关 函 数 
0s_tmr. c 人 定时 器 相关 函数 
os_var. c> 变 量 定义 相关 函数 
os.h?> 相 关 数 据 结构 类 型 定义 


os_core. c 耻 整个 kLC/0S-III 相 对 比较 底层 的 函数 ， 供 其 他 内 核对 象 函 数 调用 ， 另 外 部 分 是 hC/0S-III 核 心 的 函数 





@ 库 
lib_ascii.c 
lib ascii.h 

lib_def.h 
lib_math. c 
lib_math. h 
lib_mem_a. asm 
lib_mem. ¢ 
lib_men.h 
lib_str.c 
lib_str.h 














轿 uC/0S-III 与 移植 相关 代码 
移植 时 需要 根据 不 同 的 CPU 进行 编写 


os_cpu_a. asm>CPU 相 关 的 汇编 函数 定义 及 声明 ， 比 如 关中 断 、 前 导 零 指令 的 调用 


os_cpu_c. c>CPU 相 关 的 C 语 言 函数 定义 及 声明 ，(C 语 言 计算 前 导 零 个 数 等 等 
os_cpu. h>CPU 相 关 配 置 及 以 上 两 个 文件 中 函数 的 声明 


@ nC/0S-III 与 CPU 相 关 代 码 
cpu_def. h>CPU 相 关 配 置 ， 比 如 关中 断 的 方式 ， 堆 栈 增长 方向 ， 字 长 等 等 。 
cpu_c. cu C/0S-III 封 装 好 的 CPU 相关 (语言 代码 ， 比 如 中 断 优 先 级 的 设置 
cpu_a. asm 人 uC/V0S-III 封 装 好 的 CPU 相关 汇编 代码 ， 比 如 关中 断 
cpu_core. c 耻 CPU 的 初始 化 函数 、CPU 名 字 、 时 间 玲 计算 等 CPU 核 心 函数 


app. h 了 任务 相关 声明 、 堆 栈 大 小 的 定义 、 优 先 级 的 设置 





@ 其 他 CPU 相关 文件 


cpu_core. h 耻 CPU 核心 配置 ， 编 译 设置 ，cpu_core. 相关 函数 的 声明 等 








图 1-4 khC/OS-IIT 文 件 结构 


从 图 1-4 中 可 以 看 出 HC/OS- 吊 文件 结构 层次 分 明 ， 我 们 仅 需 修改 @@、@ 这 两 部 分 的 代码 即 可 ， 直 到 不 同 的 CPU。 


1.4 uC/OS-ll| 数 据 结 构 简 介 


学 习 OS (操作 系统 ) ， 很 重要 的 也 是 很 基础 的 就 是 要 先 了 解 它 里 面 复杂 繁多 的 数据 结构 。 数 据 结 构 是 程序 操作 的 对 象 ， 操 作 的 过 程 都 建立 在 这 
些 数据 结构 的 基础 上 面 ， 操 作对 象 搞 明 白 了 ， 操 作 的 过 程 也 很 容易 懂 。 不 管 学 习 什 么 OS 的 源码 ， 笔 者 建议 大 家 一 定 要 在 前 面 花 些 时 间 去 了 解 它 的 数 
据 结构 ， 并 做 做 笔记 、 画 画图 。 


如 果 读 者 自学 uC/OS-lll， 则 可 能 会 被 JC/OS-lll 中 “ 指 来 指 去 ”的 指针 搞 晕 。 为 什么 要 搞 这 么 复杂 的 数据 结构 呢 ? 数据 结构 虽然 复杂 ， 但 是 操作 
却 容易 ， 在 函数 的 入 口 只 要 输入 一 个 简单 的 变量 就 可 以 找到 很 多 相关 的 变量 。 同 时 ， 设 计 好 的 数据 结构 也 方便 程序 的 编写 。 如 果 读 者 还 没有 学 过 数据 
结构 ， 建 议 同时 看 看 《大 话 数 据 结构 》 这 本 书 。 对 于 本 书 来 讲 ， 只 要 了 解 前 面 的 线性 表 章 节 就 可 。 本 书后 面 介绍 内 核对 象 的 章节 都 会 讲解 相关 的 数据 
结构 。 读 者 要 是 清楚 这 些 数 据 结 构 ， 那 就 在 后 面 讲 到 这 些 相关 变量 操作 的 时 候 再 回来 看 看 那些 图 片 。 笔 者 也 没有 记 住 多 少 内 容 ， 只 是 看 名 字 就 大 概 知 
道 它 们 的 作用 以 及 它们 之 间 的 关系 。 图 片 可 以 让 大 家 更 好 地 理解 数据 结构 的 关系 ， 所 以 本 书 笔者 精心 制作 了 多 幅 图 片 来 讲解 它们 之 间 的 关系 。 下 面 以 
节拍 列表 的 数据 结构 图 来 讲解 应 该 怎么 看 这 些 图 片 ( 见 图 1-5) 。 


OS_TICK_SPOKE 







FirstPtr 
NbrEntries 
NbrEntrMax 


0OSCfg TickWheel [0] 















0OS_TCB 0OS_TCB 


TickPrevPtr 
TickNextPtr 
TickRemain 
TickCtrMatch 
TaskState 


MsgPtr MsgPtr 





MsgSize MsgSize 


PendStatus 
0S_TICK_SPOKE TickSpokePtr 





























FirstPtr 
NbrEntries 
NbrEntrMax 





OsCfg TickWheel[1] 





OS_TCB OS_TCB 


TickPrevPtr 



































TickNextPtr TickNextPtr 0 
TickRemain TickRemain 
其 他 元 素 
0SCfg_TickWheel[0S_CFG_TICK_WHEEL_STZE-1]|NbrEntries | 
0S_TCB 0S_TCB 
Toei | Tice 


TickRemain TickRemain 





TickCtrMatch TickCtrMatch 





TaskState TaskState 
TS 





TS 








图 1-5 TickList 数 据 结构 


第 一 眼看 图 1-5， 读 者 可 能 有 点 看 不 明白 。 这 种 图 在 本 书 中 很 常见 ， 也 常见 于 数据 结构 的 书 ， 本 书 用 这 样 的 图 来 展示 出 HC/OS- 员 中 的 各 种 数据 结 
构 。 从 图 1-5 中 首先 可 以 看 到 由 几 个 小 方 格 组 成 一 个 大 方 格 。 大 方 格 表示 一 个 结构 体 类 型 ， 大 方 格 上 面 的 名 称 就 是 相应 的 结构 体 类 型 的 名 称 ; 小 方 格 
是 大 方 格 的 成 员 ， 小 方 格 里 面 的 名 称 表示 成 员 的 名 称 。 大 方 格 左 侧 是 具体 的 结构 体 变量 的 名 称 ， 如 图 1-5 左 上 角 中 的 OsCfgTickWheel[O] 是 一 个 








OS TICK_SPOKE 类 型 的 结构 体 ， 结 构 体 中 有 三 个 成 员 ， 分 别 是 FirstPtr、NbrEntries、NbrEntrMax。Entry 表 示 条 目 ， 记 载 数量 的 变量 名 经 常 有 这 
个 单词 。Nbr 是 number 的 缩写 ，pC/OS-lll 中 有 很 多 变量 ,， 干 万 不 要 死记 硬 背 ， 而 要 根据 其 命名 和 习惯 来 知道 它们 代表 什么 ， 这 点 对 理解 源码 也 是 很 
有 帮助 的 。 





从 图 1-5 的 右边 可 以 看 到 几 个 由 单 向 箭头 组 成 的 双向 箭头 ， 双 向 箭头 表示 双向 链表 。 值 得 注意 的 是 ， 虽 然 TickNextPtr 在 图 中 看 起 来 是 指向 下 一 个 
结构 体 的 TickNextPtr， 但 实际 上 是 TickNextPtr 存 放下 一 个 结构 体 的 地 址 。 如 果 不 知 道 双向 链表 的 含义 ， 请 参阅 数据 结构 相关 的 书籍 。 


从 图 1-5 中 还 可 以 看 到 有 很 多 个 箭头 ， 箭 头 代表 指向 其 他 变量 的 指针 ， 如 图 1-5 中 最 上 方 的 一 个 箭头 表示 的 就 是 OSCfg_TickWheel[0] (结构 体 ) 
的 成 员 FirstPtr 存 放 的 是 OS_TCB 类 型 的 数据 。 


后 面 若 有 相关 的 图 ， 也 是 按照 上 面 的 解释 来 解读 。 


1.5 任务 


在 hC/OS- 吊 的 管理 下 ， 可 以 创建 多 个 任务 ， 并 让 它们 看 起 来 是 各 自 有 一 个 CPU 在 并 发 运行 。 例 如 在 计算 机 上 ， 我 们 可 以 一 边 浏览 网 页 ， 一 边 听 
歌 ， 这 也 得 亏 操作 系统 的 管理 。 任 务 一 般 都 是 死 循 环 ， 如 果 只 想 任务 运行 一 次 ， 那 么 可 以 在 执行 完 任务 后 将 其 删除 。OS_TCB 结 构 体 类 型 可 以 定义 任 
务 控制 块 ， 每 个 任务 都 会 有 这 样 一 个 结构 体 变量 ， 里 面包 含 任务 的 各 种 信息 ， 包 括 优先 级 、 任 务 的 状态 、 堆 栈 的 基地 址 、 任 务 名 称 等 。OS_TCB 为 每 
个 任务 定义 的 任务 控制 块 可 以 看 成 是 任务 的 “身份 证 ”， “身份 证 ”包含 任务 的 各 种 信息 。 





任务 的 状态 


理解 好 任务 的 几 个 状态 十 分 重要 ， 内 核 中 所 有 的 程序 几乎 都 涉及 这 些 状态 的 转化 。 任 务 将 其 状态 保存 在 任务 控制 块 的 元 素 TaskState 中 。 


1) OS_TASK_STATE_RDY: 就 绪 状 态 。hC/OS- 员 可 能 有 多 个 任务 处 于 就 绪 状 态 ， 但 只 能 是 其 中 优先 级 最 高 的 任务 占用 CPU， 因 为 CPU 只 有 一 
个 ， 不 可 能 多 个 任务 一 起 并 行 运行 。 运 行 的 任务 是 就 绪 状 态 。 创 建 任务 完成 的 时 候 也 是 就 绪 状态 。 

2) OS TASK _ STATE_DLY: 延 时 状态 。 用 官方 的 延 时 函数 (OSTimeDly/OSTimeDlyHMSM) 将 其 设置 为 这 种 状态 ， 这 时 任务 会 放弃 CPU 让 其 
他 就 绪 任务 中 优先 级 最 高 的 任务 运行 ， 如 果 没 有 任务 就 绪 ， 系 统 就 会 运行 优先 级 最 低 的 空闲 任务 一 这 其 实 就 是 不 断 地 给 变量 做 加 法 的 任务 。 





3) OS_TASK_STATE_PEND: 任务 在 等 待 某 些 事情 的 发 生 ， 比 如 等 待 其 他 任务 释放 资源 后 发 送 一 个 信号 量 来 让 任务 运行 ， 也 可 以 是 其 他 的 任务 
发 送 消息 过 来 等 。 将 其 设置 为 这 种 状态 的 一 般 都 是 名 字 中 含有 Pend 的 内 核 函 数 ， 比 如 OsQPend、OSssemPend 等 。 





4) OS _ TASK_ STATE_PEND_TIMEOUT: 也 是 任务 在 等 待 某 些 事件 的 发 生 ， 不 过 这 是 要 经 过 超时 检测 的 ， 一 旦 任务 调用 等 待 函数 ODSQPend、 
OSssempPend 等 将 任务 处 于 等 待 状态 ， 就 要 设置 超时 的 时 间 。 如 果 超 时 时 间 设 置 为 0， 那 么 任务 就 是 OS_ TASK_STATE_PEND， 即 无 限期 地 等 下 去 ， 
直到 事件 发 生 。 如 果 超 时 时 间 设 置 为 N (N>0) ， 设 置 为 等 待 后 的 时 间 N 内 任务 状态 就 是 OS TASK_STATE_PEND TIMEOUT， 在 等 待 N 个 系统 节拍 
后 事件 还 是 没有 发 生 就 会 退出 等 待 状态 而 转 为 就 绪 状态 。 


5) OS TASK_STATE_ SUSPENDED: 挂 起 状态 ， 可 以 理解 为 强行 暂停 一 个 任务 。 


6) OS_TASK_STATE_DLY_SUSPENDED: 这 种 情况 就 是 任务 自己 先 产生 一 个 延 时 ， 延 时 没有 结束 的 时 候 又 被 其 他 的 任务 挂 起 。 注 意 ， 不 是 挂 起 
后 又 被 延 时 ， 因 为 挂 起 的 时 候 任务 已 经 被 剥夺 了 CPU 的 使 用 权 ， 而 延 时 的 时 候 只 能 自己 延 时 自己 。 需 要 这 两 种 状态 都 解除 才 可 以 就 绪 。 








7) OS_TASK_STATE_PEND_SUSPENDED: 这 种 情况 也 是 任务 自己 先 等 待 一 个 事件 的 发 生 ， 还 没有 等 到 事件 发 生 就 又 被 挂 起 。 需 要 两 种 状态 都 
解除 才 可 以 就 绪 。 


8) OS_TASK_STATE_PEND_TIMEOUT_SUSPENDED: 与 上 面 的 状态 一 样 ， 只 是 加 了 一 个 超时 检测 。 需 要 两 种 状态 都 解除 才 可 以 就 绪 。 





9) OS_TASK_STATE_DEL: 任务 被 删除 后 的 状态 。 任 务 被 删除 后 将 不 再 运行 ， 要 让 其 恢复 运行 只 能 重新 创建 任务 。 


1.6 ”内 核对 象 简介 


内 核对 象 有 很 大 一 部 分 是 为 任务 服务 的 ， 比 如 想 在 两 个 任务 之 间 传 递 数据 就 可 以 采用 消息 队列 。 任 务 之 间 是 相互 独立 的 ， 它 们 之 间 的 “沟通 ”是 
通过 内 核 来 完成 的 。 所 有 的 内 核对 象 包括 任务 、 堆 栈 、 信 号 量 、 事 件 标志 组 、 消 息 队 列 、 消 息 、 互 斥 信号 量 、 内 存 分 区 、 软 件 定时 器 等 。 





1.7 uC/OS- 咱 常见 的 程序 段 


本 节 介 绍 的 是 经 常 在 程序 中 出 现 的 相似 的 程序 段 。 


1.8 总 结 


/GAN2 口 


本 章 首先 介绍 了 单片机 程序 框架 ， 从 最 简单 的 前 后 台 系 统 到 时 间 片 轮 询 法 、 再 到 嵌入 式 实 时 操作 系统 。 它 们 分 别 对 应 不 同 层次 的 应 用 ， 有 着 各 自 
的 局 限 和 优势 。 


接着 介绍 了 HC/OS-lll 整 体 的 文件 框架 ， 从 CPU 相 关 移 植 代码 到 uC/OS-lll 的 主体 代码 ( 跟 CPU 无 关 ) ， 再 到 用 户 的 应 用 层 代 码 。 层 次 感 非常 强 ， 
方便 移植 uC/OS-lIll 到 不 同 的 CPU 上 去 。 


最 后 介绍 了 hC/OSs- 吊 任务、 内核 对象 以 及 常见 代码 段 ， 这 些 是 为 后 面 的 内 容 做 铺垫 ， 了 解 即 可 。 


第 2 章 ”时 钟 节拍 


所 谓 时 钟 节拍 ， 就 是 CPU 以 固定 的 频率 产生 中 断 ， 可 以 看 成 是 操作 系统 的 “心跳 ”。 内 核 可 以 利用 这 个 时 钟 节拍 来 管理 各 个 任务 的 一 些 时 间 管 
理 ， 比 如 延 时 、 定 时 、 超 时 检测 、 时 间 片 轮转 调度 等 。 总 之 ， 内 核 中 跟 时 间 有 关 的 都 跟 时 间 节 拍 有 关 。 


还 没有 了 解 时钟 节 拍 是 怎么 运作 之 前 ， 读 者 可 以 想 想 ， 有 时 一 个 系统 可 能 会 有 多 个 任务 在 延 时 ， 常 规 的 检查 办 法 需要 每 次 时 钟 节拍 到 来 的 时 候 都 
检查 这 些 延 期 的 任务 是 否 到 期 ， 这 种 情况 下 有 什么 办 法 可 以 减轻 系统 的 负担 ”如 果 没有 想到 好 的 办 法 ， 就 让 我 们 一 起 来 领略 HC/OS- 员 的 奥妙 吧 。 


2.1 系统 节拍 中 断 服务 程序 


时 钟 节拍 的 频率 可 以 为 10Hz~ 1000Hz。 频 率 太 低 会 让 有 些 任务 不 能 及 时 就 绪 (在 每 次 时 钟 节拍 到 来 前 都 会 检查 是 否 要 进行 任务 调度 ) ， 因 为 每 
个 时 钟 节拍 到 来 系统 都 会 进行 一 些 超时 检测 等 ;频率 太 高 会 导致 内 核 的 负担 加 重 。 本 书 的 例 程 都 采用 1000Hz 的 时 钟 节拍 ,但 在 os_cfg_app.c 文 件 中 
需要 根据 实际 节拍 频率 来 设置 这 个 宏 的 值 如 下 所 示 。 仔 细 查 看 这 个 宏 的 名 称 ， 其 实 很 快 就 可 以 明白 它 的 含义 。 所 以 在 自己 命名 一 些 变 量 或 者 宏 的 时 
候 ， 也 应 尽量 做 到 通俗 易 懂 。 


1 #define OS CFG TICK RATE HZ 1000u 


每 次 产生 系统 节拍 的 时 候 ， 系 统 会 执行 中 断 服务 程序 ， 在 中 断 服务 程序 中 再 调用 一 个 函数 OSTimeTick， 调 用 的 过 程 如 代码 清单 2-1 所 示 。 其 中 ， 
第 3、5 行 是 前 面 介 绍 过 的 中 断 妊 套 统计 函数 ，OSTimeTick 就 是 节拍 中 断 中 所 做 事情 的 函数 。 


注意 : CPU 产生 时 钟 节拍 的 方法 有 很 多 ， 可 以 都 是 中 断 ， 也 可 以 是 某 种 固定 频率 的 中 断 源 。 本 书 例 程 采用 芯片 提供 的 系统 滴答 定时 器 。 


代码 清单 2-1 节拍 中 断 调用 OsTimeTick 


voiqd SysTick Handler (void) 
{ 


1 

2 

3 OSIntEnter () ; // 用 于 统计 中 断 的 谋 套 层 数 ， 对 谋 套 层 数 加 1 
4 OSTimeTick (); // 统计 时 间 ， 人 遍历 任务 ， 对 延 时 任务 计时 减 1 
5 OSIntExit (); // 对 峰 套 层 数 减 1， 在 退出 中 断 前 启动 任务 调度 
6 } 


下 面 仔 细 查 看 代码 清单 2-2 第 4 行 的 OSTimeTick 函 数 的 内 容 。 


代码 清单 2-2 OSTimeTick 函 数 




















1 void OSTimeTick (void) 
2 1{ 
3 OS ERR err; 
4 #if OS CFG ISR POST DEFERRED EN > 0u 
5 CPU TS ts; 
6 #endif 
7 
8 
9 OSTimeTickHook (); 
10 
11 #if OS CFG ISR POST DEFERRED EN > 0u 
4 
13 ts = OS TS GET(); 
14 OS_IntQPost ((OS OBJ TYPE) OS OBJ TYPE TICK, 
二 与 (void *) &OSRdyList [OSPrioCur], 
16 (void 类 本 
17 (OS _ MSG SIZE) Ou, 
18 (OS FLAGS ) 0u， 
19 (OS_OPT ) Ou, 
20 (CPU _ TS } Ess 
21 (OS_ERR *) &err); 
22 
23 #else 
24 
25 (void)OSTaskSemPost ( (OS_ TCB *) &OSTickTaskTCB， 
26 (OS OPT ) OS OPT POST NONE, 
27 (OS_ERR *)&err); 


#if OS CFG SCHED ROUND ROBIN EN > 0u 
OS_SchedRoundRobin (&OSRdyList [OSPrioCur]); 
#endif 





#if OS CFG TMR EN > 0u 
OsSTmrUpdateCtr-——; 
if (OSTmrUpdateCtr == (OS CTR)Ou) { 
OsTmrUpdateCtr = OSTmrUpdateCnt; 
OSTaskSemPost ( (OS_TCB *) &OSTmrTaskTCB， 
(OS OPT ) OS OPT POST NONE, 
(OS_ERR *)&err); 


心心 Wwwwwwwwwwm 
户口 避 Do 和 wwWPP 忆 口 oo 


} 
#endif 


#endif 
} 


心 心 心心 
nn 心 ww 


首先 ， 代 码 段 中 有 多 个 #if、#else、#endif，hC/OS-Il 可 利用 条 件 编译 来 让 代码 具有 可 裁 瘟 性 。 只 要 #if 里 非 0 (0 为 假 ， 非 0 为 真 ) ， 就 可 将 #if 
里 的 内 容 编译 进来 ，#else 同 理 。 如 果 不 需 要 用 到 队列 ， 那 么 只 需 将 队列 的 宏 OS_CFG_Q_EN 置 0， 就 不 能 将 队列 的 代码 编译 进来 ， 这 样 可 以 任意 改变 
使 用 的 功能 和 裁剪 代码 。 这 里 需要 对 比 经 常用 到 的 if。if 不 管 条 件 真 假 ， 代 码 都 会 被 编译 进去 。 


一 开始 执行 的 是 OSTimeTickHook， 这 是 一 个 钩子 函数 ， 可 以 简单 理解 为 这 是 你 自己 自由 编写 的 函数 ， 如 代码 清单 2-3 所 示 。 系 统 在 这 里 设置 钩 
子 函 数 的 原因 是 : 如 果 有 一 个 事件 要 在 产生 时 间 节 拍 的 时 候 运 行 ， 就 可 以 在 这 里 设置 ; 如 果 某 段 程序 的 执行 周期 是 1 个 时 间 节 拍 ， 那 么 最 好 放 在 这 个 
钩子 里 面 ， 如果 用 延 时 函数 延 时 1 个 时 间 节 拍 ， 则 会 不 准确 ， 这 在 时 间 管 理 章节 会 讲解 到 。 要 想 使 用 钩子 函数 ， 要 先 将 宏 OS_ CFG_APP_HOOKS_EN 
置 1。 接 下 来 介绍 OSTimeTickHook 的 具体 内 容 ， 先 判断 OS_AppTimeTickHookPtr 是 否 为 空 指 针 ， 如 果 不 是 ， 则 调用 OS AppTimeTickHookPtr。 
这 里 关系 到 函数 指针 的 用 法 。 对 于 一 个 函数 ， 调 用 的 时 候 既 可 以 写成 ” (* 函 数 名 ) 0;”， 也 可 以 写成 “函数 名 0;”。 平 常见 得 最 多 的 是 第 二 种 ， 而 这 
里 使 用 的 是 第 一 种 ， 如 代码 清单 2-3 所 示 。 





代码 清单 2-3 OSTimeTickHook 函 数 


void OSTimeTickHook (void) 
{ 
#if OS CFG APP HOOKS EN > Ou 
if (OS AppTimeTickHookPtr != (OS APP HOOK VOID)0) { 
(*OS_ AppTimeTickHookPtr) (); 


} 
#endif 
} 


OAOOOPODP 


如 果 将 定义 的 函数 名 称 My_ Hook_Function 赋 给 系统 定义 的 全 局 函数 指针 变量 OS AppTimeTickHookPtr， 则 定义 的 函数 自然 就 以 系统 节拍 的 频 


率 执行 。 每 次 系统 节拍 到 来 时 都 会 调用 这 个 函数 ， 如 代码 清单 2-4 所 示 。 
代码 清单 2-4 ”钩子 函数 的 初始 化 过 程 


OS_APPTimeTickHookPtr = (OS APP HOOK TCB)My Hook Function; 





表 2-1 是 hC/OS- 员 所 有 的 钩子 函数 及 其 执行 场合 。 


表 2-1 所 有 的 钩子 函数 及 其 执行 场合 


函数 指针 执行 场合 
OS_AppTaskCreateHookPtr 每 次 创建 任务 的 时 候 
OS_AppTaskDelHookPtr 每 次 任务 被 删除 的 时 候 
OS_AppTaskReturnHookPtr 任务 返回 的 时 候 

( 绪 ) 

函数 指针 执行 场合 
OS_AppIdleTaskHookPtr 执行 空闲 任务 的 时 候 循环 执行 
OS_AppStatTaskHookPtr 执行 统计 任务 的 时 候 循 环 执行 
OS AppTaskSwHookPtr 每 次 任务 切换 的 时 候 
OS_AppTimeTickHookPtr 每 次 时 钟 节拍 到 来 的 时 候 


回 到 时 钟 节拍 调用 的 函数 OsTimeTick， 代 和 码 清单 2-2 第 11~27 行 都 是 给 时 钟 节拍 任务 OSTickTaskTCB 发 送 任务 信号 量 ， 这 里 的 信号 量 用 来 告诉 
时 钟 节拍 任务 已 经 到 来 。 虽 然 有 两 个 分 支 ， 但 是 它们 只 是 两 种 不 同 发 布 消息 的 方式 。 如 果 OS_CFG _ISR_POST_DEFERRED_EN 这 个 中 断 延 迟 的 宏 定义 
为 1， 则 将 采取 延迟 发 布 的 形式 ， 中 断 的 时 候 只 保存 发 布 函 数 的 相关 信息 ， 退 出 中 断 的 时 候 让 优先 级 最 高 的 延迟 发 布 任务 就 绪 并 进行 延迟 发 布 。 上 面 
介绍 的 将 中 断 级 的 事情 转化 为 任务 级 可 以 提高 系统 的 实时 性 ， 这 里 也 是 相同 的 原理 。 如 果 将 OS_CFG_ISR_POST_DEFERRED_EN 定 义 为 0， 那 就 按照 
常规 发 布 函数 的 方法 来 发 布 内 核对 象 ， 这 样 会 增加 关中 断 的 时 间 。 


接 下 来 看 看 时 钟 节拍 任务 的 执行 过 程 ， 聪 明 的 读者 肯定 知道 这 时 时 钟 节拍 任务 一 定 在 等 待 |SR 给 它 发 消息 。 时 钟 节拍 处 理 不 是 直接 在 ISR 中 处 理 ， 
而 是 作为 一 个 任务 来 处 理 ， 这 样 的 好 处 是 中 断 占 用 的 时 间 少 。hC/OS- 吊 在 其 手册 上 也 将 这 点 作为 其 改进 的 特性 之 一 。 中 断 函 数 应 该 要 处 理 简短 重要 
的 事情 ， 如 果 事 情 很 重要 而 且 比较 长 ， 那 么 可 以 在 IlSR 中 发 消息 给 优先 级 比较 高 的 任务 ， 要 处 理 的 事情 放 在 这 个 任务 中 ， 并 且 将 其 挂 起 ， 等 待 |SR 给 其 
发 信息 才 执 行 ， 这 样 就 将 中 断 级 转化 为 任务 级 。 





注意 : 时 钟 节拍 到 来 的 时 候 ， 做 的 事情 很 多 ， 代 码 清单 2-2 第 30~42 行 是 与 时 间 片 轮转 调度 、 定 时 器 相关 的 ， 暂 不 讨论 。 


2.2 ”节拍 任务 处 理 时 间 相 关 事 务 





在 代码 清单 2-5 中 ， 任 务 的 死 循环 中 调用 了 OSTaskSemPend 以 等 待 |SR 给 其 发 送信 号 量 。 初 次 见 到 这 些 陌 生 的 函数 不 用 担心 ， 一 看 名 称 ， 二 看 函 
数 定义 处 的 英文 解析 ， 一 般 都 会 明白 。 如 果 OSTaskSemPend 执 行 过 程 没有 出 现 错误 且 OS 已 经 开始 ， 就 调用 OS_TickListUpdate， 真 正 处 理 延 时 、 超 
时 等 就 在 这 里 。 处 理 完 之 后 还 在 任务 的 死 循环 里 ， 继 续 等 待 下 一 个 时 钟 节拍 的 到 来 。 


代码 清单 2-5 ”时 钟 节拍 任务 


void OS TickTask (void *p arg) 
{ 


OS ERR err; 
CPU TS ts; 


Pp _ arg ms Pp_arg; 
while (DEF ON) { 


// 等 待 任务 信号 量 
(void)OsTaskSemPend( (OS TICK )0, 
(OS OPT  )OS OPT PEND BLOCKING, 


下 
2 
3 
4 
6 
7 
8 
9 
10 
11 
2 
13 
14 (CPU TS *)&ts, 


19 (OS ERR *)&err); 


16 

17 

18 if (err == OS ERR NONE) { 
19 // 检查 系统 是 否 正 在 运行 
20 if (OSRunning == OS_ STATE OS RUNNING) { 
2 // 时 钟 节拍 更 新 函数 
22 OS TickListUpdate(); 
23 } 

24 } 

25 } 

26 } 


注意 : hC/OS- 山 中 死 循 环 使 用 的 都 是 while (DEF_ON) {，DEF_ON 被 宏 定义 为 1， 这 也 是 hC/Os- 册 的 一 种 代码 规范 。 一 般 来 说 ，HC/OS-l 函 
数 的 第 一 个 参数 都 是 操作 的 对 象 ， 最 后 一 个 参数 就 是 错误 信息 ，OSTaskSemPend 同 样 也 符合 这 样 的 规则 。 


2.3 总 结 


CPU 以 一 定 的 频率 产生 中 断 ， 这 就 是 时 钟 节拍 。 每 个 时 钟 节拍 到 来 时 ，OS 首 先 给 时 钟 节拍 任务 发 送 一 个 信号 量 ， 时 钟 节拍 任务 收 到 信号 量 之 后 
就 更 新 TickList。 当 任务 插入 列表 的 时 候 ， 会 将 某 常数 余数 相同 的 放 在 特定 数组 的 一 个 相同 元 素 里 ， 并 用 链表 将 其 串 起 来 。 系 统 首先 会 计算 OsTickCtr 
对 常数 的 余数 ， 取 出 数组 中 存放 与 这 个 余数 相同 的 那个 元 素 ; 然后 根据 链表 的 指向 找 出 任务 并 进行 判断 和 相应 的 操作 。 


第 3 章 ”时间 管理 


第 2 章 介绍 了 内 核 是 怎么 在 时 钟 节拍 到 来 的 时 候 更 新 节拍 列表 的 ， 从 第 2 章 的 内 容 可 以 知道 ， 任 务 通过 哈 希 算法 计算 之 后 分 成 几 组 ， 并 且 每 组 的 排 
列 顺 序 是 按照 到 期 的 时 间 长 短 来 进行 排列 的 。 本 章 介绍 任务 插入 节拍 列表 的 实现 过 程 ， 在 调用 延 时 函数 时 也 会 涉及 这 个 过 程 。 





3.1 实例 演示 


本 书 所 有 例 程 及 其 他 资料 都 可 以 在 论坛 www.bbsxiaolong.com 的 uC/OS- 川 版 块 中 下 载 。 
创建 另 一 个 使 用 延 时 函数 和 测量 延 时 时 间 的 任务 ， 关 键 代 码 如 代码 清单 3-1 所 示 。 


代码 清单 3-1 测量 延 时 时 间 任 务 


一 < 


oid Task TS (void *p arg) 


OS ERR err; 
CPU_TS ts_start; 
CPU_ TS ts_end; 


(void)p arg; 
while (1) { 

// 获取 延 时 之 前 的 时 间 惟 
ts_start = OS_TS GET(); 


// 延 时 阻塞 1?s? 
OSTimeD1yHMSM(0，0,1,0,0S_OPT _ TIME HMSM STRICT, &err); 


// 获取 延 时 之 后 的 时 间 惟 并 减 去 延 时 之 前 的 时 间 蕉 
ts end = OS TS GET() - ts start; 


\Do~ONUwNDDHPOo~ ON 人 TD 哺 





// 打印 出 时 间 戳 测试 延 时 的 长 度 ， 时 间 改 的 计数 频率 是 72M， 由 此 推出 下 面 的 计算 
20 printf("\r\n 延 时 1?s， 时 间 戳 测试 : $d us,\ 
21 Bhsd ms",ts end/72,ts end/72000); 


分 别 在 延 时 1s 的 延 时 函数 前 后 读 取 时 间 戳 ， 然 后 相 减 得 到 总 共 经 历 的 时 间 戳 个 数 。 时 间 戳 的 计数 频率 是 72M ， 即 1s 会 从 0 计数 到 72000000，1ms 
会 从 0 计数 到 72000，1hs 会 从 0 计数 到 72， 打 印 时 的 单位 转化 即 从 这 里 来 ， 如 图 3-1 所 示 。 
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图 3-1 串口 打印 延 时 测试 结果 


从 图 3-1 所 示 的 串口 打印 的 结果 来 看 ， 精 度 还 是 相当 高 的 ， 延 时 时 间 都 是 偏 少 的 。 存 在 些许 误差 的 原因 主要 是 在 插入 的 时 候 可 能 在 两 个 节拍 的 任 
何 时 刻 ， 退 出 延 时 一 定 是 在 节拍 到 来 处 理 节拍 任务 的 时 候 。 如 图 3-2 所 示 ， 虽 然 设置 延 时 节拍 的 个 数 是 5 个 ， 但 延 时 的 节拍 比 大 部 分 会 小 于 5 个 。 图 中 
的 小 黑 块 表示 节拍 任务 的 处 理 。 


人 E 富 茵 湛 时 
[ 2 
时 个 时 刻 任务 开始 延 时 延 时 结束 


图 3-2 ” 延 时 误差 示意 图 
下 面 看 看 延 时 函数 是 怎么 使 用 的 。 


延 时 函数 用 来 阻塞 任务 ， 调 用 这 个 函数 之 后 任务 会 让 出 CPU，OSs 执 行 调度 ， 执 行 就 绪 列表 中 优先 级 最 高 的 任务 。 这 个 函数 跟 平 常 自己 写 的 延 时 


函数 不 一 样 ， 它 不 会 占用 CPU。 以 下 对 话 可 能 让 你 更 理解 。 


任务 : “1s 后 再 来 我 这 干 活 吧 。” 
CPU: “好 ,没什么 事 那 我 就 先 去 执行 别 的 任务 了 ，1s 后 如 果 你 的 优先 级 达到 最 高 我 再 回来 。” 


将 OS_CFG_TIME_DLY_HMSM_EN 置 1 后 才能 使 用 OSTimeDlyHMSM。 先 不 看 使 能 也 没有 关系 ， 因 为 没有 使 能 ,程序 编译 会 报错 说 函数 没有 定 
然后 返回 查看 函数 的 定义 由 哪个 宏 定义 导致 的 ， 然 后 修改 该 宏 定义 。 


时 间 机 关 的 参数 有 如 下 几 个 。 
1) hours: 小 时 数 ; 

2) minutes: 分 钟 数 ; 

3) seconds: 种 数 ; 

4) milli: 毫秒 数 。 


以 上 参数 设置 后 总 时 间 会 自动 相 加 。 





opt 为 延 时 模式 选项 ， 包 含 以 下 几 个 选项 

1) OSs_ OPT TIME_DLY: 如 果 设 置 这 个 选项 ， 则 延 时 时 间 是 相对 的 ， 比 如 设置 1s 后 。 

2) OS_OPT TIME TIMEOUT: 同上 。 

3) OS_OPT_TIME_MATCH: 延 时 时 间 是 绝对 的 ， 比 如 当 系 统 运行 1s 时 ， 系 统 就 开始 调用 OSStart。 

4) OS_OPT_TIME_PERIODIC: 周期 性 延 时 。 与 相对 延 时 差不多 ， 但 是 相对 长 时 间 的 周期 性 延 时 ， 该 周期 性 延 时 更 准确 一 些 

OS OPT TIME_HMSM_STRICT 选 项 设 定 的 时 间 范 围 如 下 。 

+ hours (Ohttp://www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15519/OEBPS/Text/...99) 

- minutes (Ohttp://www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15519/OEBPS/Text/...59) 
seconds (Ohttp://www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15519/OEBPS/Text/...59) 

* milliseconds (Ohttp://www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15519/OEBPS/Text/...999) 
OS_OPT_TIME_HMSM_NON_STRIC 时 间 参 数 的 范围 如 下 。 

* hours (Ohttp://www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15519/OEBPS/Text/...999) 

- minutes (Ohttp://www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15519/OEBPS/Text/...9999) 
seconds (Ohttp://www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15519/OEBPS/Text/...65535) 

* milliseconds (Ohttp://www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15519/OEBPS/Text/...4294967295) 


前 面 四 个 选项 之 一 可 以 与 后 面 两 个 选项 之 一 相 与 。 如 果 没 有 设置 相关 参数 ， 则 前 者 默认 是 OS_OPT_TIME_DLY， 后 者 默认 是 


OS OPT TIME_HMSM_STRICT, 


P_err 指 向 返回 错误 类 型 的 指针 ， 主 要 包含 以 下 几 种 类 型 (这 里 只 列举 部 分 ) 。 
1) OS_ERR_TIME_INVALID_HOURS: 小 时 数 设置 错误 ; 
2) OS ERR_TIME INVALID_MINUTES: 分 钟 数 设置 错误 ; 


3) OS_ERR TIME_INVALID SECONDS: 秒 数 设置 错误 ; 


4) OS_ERR TIME_INVALID_MILLISECONDS: 毫秒 数 设置 错误 ; 
5) OS ERR TIME ZERO_DLY: 时 间 和 设置 为 0。 


这 里 读者 有 没有 感受 到 使 用 系统 的 便利 ?在 移植 和 配置 好 系统 后 ， 即 使 你 不 懂 系统 内 部 到 底 是 怎么 运行 的 ， 也 可 以 根据 说 明 调 用 系统 函数 实现 相 
应 的 功能 。 


同 OSTimeDlyHMSM 函 数 一 样 ，OSTimeDly 函 数 也 可 以 进行 延 时 ， 但 是 OSTimeDly 函 数 设 置 延 时 的 单位 是 节拍 数 。 以 我 们 的 例 程 为 例 ， 我 们 设 
置 的 时 钟 节拍 数 是 1000Hz，1 个 节拍 数 就 是 1ms。 


用 到 的 参数 包含 以 下 几 个 。 
1) dly: 延 时 的 节拍 数 ， 具 体 延 时 的 不 仅 要 看 节拍 的 频率 ， 还 要 看 下 面 的 opt 选 项 延 时 的 模式 设置 为 什么 。 
2) opt: 意义 同 OSTimeDlyHMSM 函 数 前 四 个 参数 。 


3) p_err: 指向 返回 错误 类 型 的 指针 ， 主 要 有 (这 里 只 列举 部 分 ) : OS_ERR_TIME_ZERO_DLY， 用 于 设置 延 时 节拍 数 为 0 或 者 延 时 选项 为 
OS_OPT_TIME_MATCH， 要 延 时 的 那个 时 间 点 已 经 超过 现在 的 时 间 。 


3.2 ”任务 开始 延 时 


接 下 来 看 看 上 面 两 个 延 时 函数 是 怎么 工作 的 。OSsTimeDIly 函 数 的 代码 如 代码 清单 3-2 所 示 。 


代码 清单 3-2 ”OSTimeDly 函 数 


















































1 void OsTimeDly (OS TICK dly, 

2 OS_OPT opt, 

号 OS_ERR 人 ET) 

水 二 

5 CPU SR ALLOC(); 

6 

这 

8 

9 #ifqef OS SAFETY CRITICAL 

1 if (p err == (OS ERR *)0) { 

二 下 OS_SAFPTY _ CRITICAL _ EXCEPTION () 7 
12 return; 

13 } 

14 #engif 

1 

16 // 检查 是 否 在 中 断 中 调用 延 时 函数 

17 #if OS CFG CALLED FROM ISR CHK EN > 0u 
18 // 如 果 中 断 庶 套 大 于 0， 即 在 中 断 中 调用 
19 if (OSIntNestingCtr > (OS NESTING CTR)Ou) { 
20 *p err = OS ERR TIME DLY ISR; 
二 returrny 

22 } 

23 #endif 

24 

25 // 延 时 函数 后 面 要 阻塞 任务 ， 进 行 调度 ， 首 先 检查 调度 器 是 否 被 锁 住 
26 if (OSSchedLockNestingCtr > (OS NESTING _CTR) 0u) { 
27 *p err = OS ERR SCHED LOCKED; 
28 return; 

29 } 

30 

3 // 检查 选项 是 否 是 我 们 规定 的 几 个 

32 switch (opt) { 

33 Case OS_OPT TIME DLY: 

34 case OS_OPT TIME TIMEOUT: 

35 case OS OPT TIME PERIODIC: 

36 // 延 时 节拍 数 不 能 为 0 

37 if (dly == (OS TICK)Ou) { 

38 *p err = OS ERR TIME ZERO DLY; 
39 return; 

40 } 

41 break; 

42 

43 case OS_OPT TIME MATCH: 

44 break; 

45 

46 defauilt: 

47 *p err = OS ERR OPT INVALID; 
48 return; 

49 } 

50 

51 // 进入 临界 段 


52 OS_CRITICAL ENTER (); 


53 // 修改 任务 的 状态 为 延 时 状态 








54 OSTCBCurPtr->TaskState = OS TASK STATE DLY; 
55 // 将 任务 根据 参数 插入 节拍 列表 

56 OS_TickListInsert (OSTCBCurPtr, 

57 dly, 

58 opt, 

59 p_ err); 

60 

61 // 如 果 揪 入 节拍 列表 的 时 候 发 生 了 错误 ， 则 退出 
62 if (*p err != OS ERR NONE) { 

63 OS CRITICAL EXIT NO SCHED(); 

64 return; 

65 } 

66 // 将 任务 从 就 绪 列 表 中 脱离 

67 OS_ RdyListRemove (OSTCBCurPtr); 

68 // 退出 临界 段 ， 进 行 任务 调度 

69 OS CRITICAL EXIT NO SCHED(); 

70 OSSched () 

71 xp err = OS ERR NONE; 

72 3} 





第 32~49 行 是 检测 输入 的 选项 参数 opt 是 否 符合 要 求 ， 而 且 延 时 的 节拍 数 也 不 能 为 0。 真 正 进入 操作 的 时 候 ， 任 务 锁 住 了 调度 器 ， 进 入 临界 段 。 程 
序 主要 调用 OS_TickListlnsert 将 当前 任务 根据 延 时 的 情况 插入 节拍 列表 ， 之 后 检测 插入 的 过 程 有 没有 出 现 错误 ， 如 果 出 现 错误 就 返回 。 最 后 将 当前 任 
务 脱 离 就 绪 列表 。 


代码 清单 3-3 中 的 OSTimeDlyHMSM 跟 OSTimeDly 前 面 的 操作 有 些许 的 差别 ， 主 要 体现 在 计算 延 时 节拍 数 和 参数 检测 上 面 。 后 面 插 入 节拍 列 
表 ， 脱 离 就 绪 列表 等 都 是 差不多 的 ， 如 代码 清单 3-3 所 示 。 


代码 清单 3-3 OSTimeDlyHMSM 函 数 





#if OS CFG TIME DLY HMSM EN > Ou 

voiqd OSTimeDlyHMSM (CPU INT16U hours, 
CPU _INT16U minutes, 
CPU INT16U seconds, 
CPU INT32U milli, 
OS 总 ET opty 
OS_ERR *p_err) 





#if OS CFG ARG CHK EN > ou 
CPU BOOLEAN opt invaliqg; 


CPU BOOLEAN opt non strict; // 选项 opt 中 是 否 严格 检查 
#endif 

OS_OPT opt time; // 取出 关于 时 间 的 选项 

OS RATE HZ tick rate; // 存放 时 钟 节拍 的 频率 

OS_TICK ticks; // 存放 计算 过 程 的 时 钟 节拍 


CPU SR ALLOC(); 





人 
OO0OmO~OUPONPOUWOAOOUOPODP 


#ifdef OS SAFETY CRITICAL 





21 if (perr == (OS ERR *)0) 1 

22 OS_SAFPTY _ CRITICAL _ EXCEPTION () 
23 return; 

24 } 

25 #engdif 

26 

27 // 检测 是 否 在 中 断 中 调用 了 延 时 函数 























28 #if OS CFG CALLED FROM ISR CHK EN > 0u 

29 if (OSIntNestingCtr > (OS NESTING CTR)Ou) { 
30 *p err = OS ERR TIME DLY ISR; 

31 return; 

32 } 

33 #engdif 

34 

35 // 后 面 任务 延 时 的 时 候 要 进行 任务 调度 ， 调 度 器 不 能 锁 住 
36 if (OSSchedLockNestingCtr > (OS NESTING CTR)Ou) { 
SY *p err = OS ERR SCHED LOCKED; 

38 return; 

39 } 


// 通过 & 运 工 取 出 延 时 模式 选项 ， 全 部 选项 还 有 参数 范围 的 
opt time = opt & OS OPT TIME MASK; 
// 判断 延 时 模式 是 否 符合 要 求 
Switch (opt time) { 
case OS_OPT TIME DLY: 
case OS OPT TIME TIMEOUT: 
case OS_OPT TIME PERIODIC: 
// 确保 延 时 时 间 不 为 0 


























人 心心 心心 心心 心心 心心 
Oo ~ 性 wWmN 哺 口 





if (milli == (CPU INT32U) Ou) { 
if (seconds == (CPU INT16U) 0Ou) { 

S51 if (minutes == (CPU INT16U)0u) { 
ie if (hours == (CPU INT16U)0u) { 
53 *p err = OS ERR TIME ZERO DLY; 
54 return; 
55 } 
56 } 
3 } 
58 } 
39 break; 


case OS_OPT TIME MATCH: 
break; 


Onn 
ko 声优 





64 default: 

65 *p err = OS ERR OPT INVALID; 
66 return; 

67 } 

68 


69 // 参数 检测 
70 #if OS CFG ARG CHK EN > 0u 
71 // 想 查 看 除了 选项 所 有 的 位 外 ， 还 有 没有 被 设置 的 位 



























































































































































72 opt invalid = DEF BIT 1S SET ANY (opt, ~OS OPT TIME OPTS MASK); 
了 if (opt invalid == DEF YES) { 
74 *p err = OS ERR OPT INVALID; 
73 return; 
76 } 
77 // 查看 参数 范围 选项 的 设置 
78 opt non strict = DEF BIT IS SET(opt, OS OPT TIME HMSM NON STRICT); 
79 if (opt non strict != DEF YES) { // 如 果 设 置 为 0S OPT TIME HMSM STRICT 
80 if (milli > (CPU INT32U)999u) { 
81 *p err = OS ERR TIME INVALID MILLISECONDS; 
82 return; 
83 } 
84 if (seconds > (CPU INT16U)59u) { 
85 *p err = OS ERR TIME INVALID SECONDS; 
86 return; 
87 } 
88 if (minutes > (CPU INT16U) 59u) { 
89 *p err = OS ERR TIME INVALID MINUTES; 
90 return; 
91 } 
4 if (hours > (CPU INT16U)99u) { 
33 *p err = OS ERR TIME INVALID HOURS; 
94 return; 
95 } 
96 }] else { // 如 果 设 置 为 OS _ OPT TIME HMSM NON STRICT 
97 if (minutes > (CPU INT16U)9999u) { 
98 *p err = OS ERR TIME INVALID MINUTES; 
99 return; 
00 } 
101 if (hours > (CPU INT16U) 999u) { 
102 *p err = OS ERR TIME INVALID HOURS; 
103 Teturrny 
104 } 
i105 } 
106 #engdif 
寺村 了 
108 
109 
110 tick rate = OSCfg TickRate Hz; 
11 // 计算 需要 延 时 的 节拍 数 
12 ticks = ((OS TICK)hours * (OS TICK)3600u + (OS TICK)minutes * (OS_ 
TICK) 60u + (OS_TICK) seconds) * tick rate 
+ (tick rate * ((OS TICK)milli + (OS TICK)S500u / tick rate)) 
/ (OS TICK)1000u; 
114 
115 // 保证 节拍 数 不 为 0 
116 if (ticks > (OS TICK)Ou) { 
二 下 下 OS_CRITICAL ENTER () 
118 // 任务 状态 为 等 待 状态 
119 OSTCBCurPtr->TaskState = OS TASK STATE DLY; 
120 // 插入 节拍 列表 
121 OS TickListIinsert (OSTCBCurPtr, 
122 ticks, 
123 opt time, 
124 perr)s 
125 if (*p err != OS ERR NONE) { 
126 OS CRITICAL EXIT NO SCHED(); 
127 return; 
128 } 
129 // 将 任务 脱离 就 绪 列 表 
130 OS_ RdyListRemove (OSTCBCurPtr); 
131 OS CRITICAL EXIT NO SCHED(); 
32 // 找到 下 一 个 就 绪 任 务 进行 调度 
133 OSSched (); 
134 *p err = OS ERR NONE; 
135 } else { 
136 *p err = OS ERR TIME ZERO DLY; 
137 } 
138 } 
139 #engdif 








前 面 我 们 解释 过 opt， 其 有 两 种 不 同 的 选项 : 一 种 是 延 时 的 方式 ， 一 种 是 参数 的 范围 。 第 38~ 53 行 检查 的 是 延 时 方式 和 延 时 时 间 ， 所 以 第 38 行 进 
行 &% 运 算 的 时 候 将 设置 延 时 方式 的 其 他 选项 置 0， 设 置 延 时 方式 的 位 保持 不 变 。 宏 OS_OPT_TIME_MAsK 的 定义 如 下 ， 是 延 时 方式 全 部 位 都 置 1。 每 种 
延 时 方式 的 宏 都 是 只 有 某 位 置 1， 且 位 都 不 同 。 取 出 位 之 后 判断 是 否 是 其 中 的 一 项 。 






































1 #define OS OPT TIME MASK ( (OS_OPT) (0S_OPT TIME DLY | \ 
2 OS_OPT TIME TIMEOUT | \ 
3 OS_OPT TIME PERIODIC | \ 
4 OS_OPT TIME MATCH) ) 





第 64 行 的 宏 DEF_BIT_IS_SET_ANY (val，mask) 是 检测 val 是 否 至 少将 mask 中 置 1 的 位 其 中 一 位 置 1，~OS_OPT_TIME_OPTS_MASK 只 有 除 那 
些 不 是 opt 的 位 才 置 1， 所 以 第 64 行 就 是 检测 那些 不 是 选项 的 位 有 没有 被 置 1， 有 就 是 输入 参数 opt 出 错 了 。 








OS OPT TIME_ OPTS_ MAsK 的 定义 如 下 : 





























1 #define OS OPT TIME OPTS MASK (OS OPT TIME DLY | \ 
2 OS_OPT TIME TIMEOUT We 
3 OS OPT TIME PERIODIC LN 
4 OS_OPT TIME MATCH | \ 
5 OS_OPT TIME HMSM NON STRICT) 




















第 70 行 检测 的 是 检测 opt 参 数 范围 的 设置 情况 ， 并 根据 两 种 不 同 的 参数 范围 对 时 间 参 数 进行 检测 。 


注 : 如 果 想 设置 一 些 默 认 选项 ， 就 将 其 宏 定义 的 相应 位 定义 为 0%， 比 如 OS_OPT_TIME_DLY 和 OS_OPT_TIME_HMSM_STRICT 这 两 个 选项 都 是 这 
样子 设置 的 。 


第 103 行 将 需要 延 时 的 时 间 转 化 为 需要 延 时 的 节拍 数 ， 有 些 人 可 能 会 纳闷 其 中 的 500 是 怎么 来 的 ， 为 什么 要 这 样 做 ? 比如 当 节 拍 频 率 是 100Hz 的 
时 候 ， 我 们 需要 延 时 126ms， 这 时 就 要 考虑 这 里 的 误差 ， 因 为 周期 是 10ms， 人 怎么 也 不 可 能 准确 延 时 126ms， 这 时 要 么 延 时 120ms， 要 么 延 时 
130ms， 相 对 准确 的 应 该 是 130ms。 这 里 的 500 起 的 作用 就 是 这 样 ， 这 有 点 像 我 们 的 四 舍 五 入 。500 是 怎么 做 到 “四 舍 五 入 ”的 呢 ” 需要 注意 的 是 ， 
最 后 这 项 ( (OS_TICK) milli+ (OS_TICK) 500u/tick_rate) ) 是 以 ms 为 单位 的 ， 如 果 是 1000Vtick_rate， 即 (TVtick_rate) *1000，tick_rate 的 单 
位 是 Hz， 很 多 人 可 能 就 知道 1000Vtick_rate 是 1 个 节拍 所 需 的 毫秒 数 ，500Vtick_rate 就 是 半 个 节拍 所 需 的 毫秒 数 。 最 后 计算 节拍 数 的 时 候 ， 借 助 半 个 
节拍 所 需 的 时 间 和 取 余 运算 ， 本 来 换算 成 的 节拍 数 是 小 于 半 个 的 部 分 还 是 不 变 ， 本 来 是 大 于 半 个 节拍 的 部 分 就 变 成 整个 。 像 开始 讲 到 的 126ms， 在 
100Hz 的 情况 换算 的 节拍 数 是 12.6 个 ， 那 么 它 跟 13 个 比较 接近 ，126ms 加 上 半 个 节拍 5ms 的 时 间 为 131ms， 再 取 余 就 是 13。 如 果 开始 是 122ms， 在 
100Hz 的 情况 换 成 的 节拍 数 是 12.2 个 ， 显 然 延 时 12 个 节拍 会 比较 准确 ， 加 上 半 个 节拍 5ms 的 时 间 是 127ms， 再 进行 取 余 运算 还 是 12 个 。 最 后 换算 成 节 
拍 数 的 时 候 ( 见 下 面 这 一 行 代码 ) ， 我 们 还 发 现 为 什么 是 先 乘 以 tick_rate 再 对 1000 取 余 呢 ? 








(tick rate * ((OS TICK)milli + (OS_TICK)500u / tick rate)) /(OS_TICK)1000u 


对 1000 取 余 是 因为 ( (OS TICK) millit (OS TICK) 500uytick rate) ) 的 单位 是 ms， 乘 以 tick_rate 得 到 节拍 数 ，tick_rate 本 来 的 含义 就 是 1s 
内 的 节拍 个 数 。 为 什么 是 先 乘 以 tick_rate 呢 ? 大 家 可 以 先 比 较 5*10/12 和 5/12*10 的 区 别 ， 注 意 “/” 是 取 余 运 算 ， 前 者 得 到 的 是 4， 后 者 得 到 的 是 0， 
那 才 是 我 们 想 要 的 结果 。 肯 定 是 前 者 ， 所 以 在 进行 取 余 运算 的 时 候 一 定 要 注意 这 点 。 








3.3 ”任务 插入 节拍 列表 


接 下 来 插入 节拍 列表 和 脱离 就 绪 列 表 的 过 程 几乎 跟 OSTimeDly 一 模 一 样 ， 如 代码 清单 3-4 所 示 。 


代码 清单 3-4 OS TickListlinsert 函 数 


















































1 void OS TickListInsert (OS TCB *p tcb, 

2 OS_TICK time, 

3 OS_OPT opt, 

4 OS_ERR #5: EEE) 

51 

6 OS_TICK tick delta; // 存放 要 延 时 的 时 刻 和 当前 节拍 数 的 差 值 
7 OS_ TICK tick next; // 存放 下 一 次 任务 解除 等 待 状态 是 什么 时 候 
8 OS_TICK SPOKE *p_spoke; // 指向 根据 余数 算出 的 OSCfg TickWheel 数 组 元 素 指针 
9 OS_TCB *p tcb0; 

10 OS TCB *p tcbl; // 与 p_tcb0 一 起 用 来 调整 节拍 列表 时 存放 任务 控制 块 的 指针 
了 OS_TICK SPOKE IX spoke; // 存放 哈 希 列表 中 的 余数 

2 

3 // 首先 根据 选项 计算 任务 控制 块 的 元 素 TickCtrMatch 和 TickRemain 

4 

5 // 如 果 选 项 是 0S_OPT_TIME MATCH 

6 if (opt == OS OPT TIME MATCH) { 

7 tick delta = time - OSTickCtr - 1u; 

8 // 如 果 两 个 数 相差 太 大 

19 if (tick delta > OS TICK TH RDY) { 

20 p_ tcb->TickCtrMatch = (OS TICK ) Ou; 

21 p tcb->TickRemain = (OS TICK ) Ou; 

22 p_ tcb->TickSpokePtr = (OS TICK SPOKE *)0; 

23 *p_err = OS ERR TIME ZERO DLY; 

24 return; 

25 由 

26 // 计算 好 TickCtrMatch 和 TickRemain 

27 P_ tcb->TickCtrMatch = time; 

28 p tcb->TickRemain = tick delta + lu; 

29 

30 } else if (time > (OS TICK)Ou) { 

31 // 周期 性 延 时 

32 if (opt == OS OPT TIME PERIODIC) { 


























33 tick next = p tcb->TickCtrPrev + time; 

34 tick delta = tick next - OSTickCtr - 1u; 

35 // 将 前 面 两 行 的 等 式 代入 这 个 不 等 式 

36 if (tick delta < time) { 

37 p_ tcb->TickCtrMatch = tick next; 

38 } else { 

39 p_tcb->TickCtrMatch = OSTickCtr + time; 
40 } 

41 // 计算 好 TickCtrMatch 和 TickRemain 

42 p tcb->TickRemain = p tcb->TickCtrMatch - OSTickCtr; 
43 p_ tcb->TickCtrPrev = p tcb->TickCtrMatch; 
44 

45 } else { // 如 果 是 相对 延 时 

46 p tcb->TickCtrMatch = OSTickCtr + time; 

47 p tcb->TickRemain = time; 

48 } 

49 

50 } else {  // 延 时 的 节拍 数 小 于 或 等 于 0， 返 回 

51 p_ tcb->TickCtrMatch = (OS_TICK ) Ou; 

52 p tcb->TickRemain = (OS TICK ) Ou; 

53 P tcb->TickSpokePtr = (OS TICK SPOKE *)0; 

54 *p_err = OS ERR TIME ZERO DLY; 

55 return; 

56 } 

57 

58 // 插入 的 时 候 也 是 根据 哈 希 算法 先 算出 余数 ， 取 出 数组 元 素 

59 spoke = (OS TICK SPOKE IX) (p tcb->TickCtrMatch %$ OSCfg TickWheelSize); 
60 p_spoke = &OSCfg TickWheel[spoke]; 

61 

62 // 整个 过 程 就 是 双向 链表 的 插入 过 程 ， 早 到 期 的 插入 双向 链表 的 前 面 

63 

64 // 如 果 数 组 元 素 中 之 前 没有 元 素 

65 if (p spoke->NbrEntries == (OS OBJ QTY)0u) { 

66 // 双向 链表 没有 下 一 个 也 没有 前 一 个 

67 p_tcb->TickNextPtr = (OS_TCB 本 站 

68 五 tcb=>TickPrevPtr = (OS_TCB * Or 

69 // 指向 双向 链表 的 第 一 个 ， 即 为 当前 插入 的 

70 p_spoke->FirstPtr = ptcb; 

71 // 双向 链表 的 任务 控制 块 个 数 是 1 

72 Pp_spoke->NbrEntries = (OS OBJ QTY)1u; 

73 

a } else {// 如 果 双 向 链表 插入 之 前 已 经 有 其 他 的 任务 控制 块 

75 

76 // 取出 双向 链表 中 第 一 个 任务 控制 块 

了 Bp tecbl = p_ spoke->FirstPtr; 

78 while (p tcbl != (OS TCB *)0) { 

79 // 计算 第 一 个 任务 控制 块 剩 下 的 时 钟 节拍 数 

80 p tcbl->TickRemain = p tcbl->TickCtrMatch 

81 一 OSTickCtr; 

82 // 因为 播 入 的 位 置 是 要 根据 剩 下 的 节拍 数 从 小 到 大 进行 排序 ， 所 以 要 进行 比较 
83 // 如 果 插 入 的 任务 控制 块 剩 下 的 时 钟 节拍 数 比 较 多 

84 if (p tcb->TickRemain > P tcbl->TickRemain) { 
85 // 如 果 双 向 链表 上 有 下 一 个 任务 控制 块 

86 if (p tcbl->TickNextPtr != (OS TCB *)0) { 
87 // 取出 下 一 个 任务 控制 块 进行 比较 

88 Btebl = pb tcbl=>TickNextPtr; 
89 } else { 

90 /* 插 入 的 任务 控制 块 剩 下 的 节拍 数 最 多 ， 而 且 已 经 比较 到 最 后 一 个 ， 
91 直接 插入 最 后 */ 

92 p_tcb->TickNextPtr = (OS_ TCB *)0; 
33 p tcob->TickPrevPtr = pb tecbl; 

94 pb tobl=>TickNextPtr = pp tcb; 

95 // 退出 循环 

96 p_tcbl = (OS TCB *)'0;} 
397 } 

98 } else { // 插入 的 任务 控制 块 剩 下 的 节拍 数 比 较 小 ， 准 备 插入 前 面 
99 // 如 果 要 插入 第 一 个 的 前 面 

100 if (p tcbl->TickPrevPtr == (OS TCB *)0) { 
UL p_tcb->TickPrevPtr = (O08 TCB *)0; 
102 p tcb->TickNextPtr = p tcbl; 

103 p. tecbl->TickPrevPtr = p tebs 

104 p_spoke->FirstPtr = Pp teb; 

105 } else { // 如 果 不 是 要 插入 第 一 个 的 前 面 
106 p_tcb0 = Pp tcbl->TickPrevPtr; 
107 p tcb->TickPrevPtr = p tcb0; 

108 p tcb->TickNextPtr = Pp tcbl; 

109 p_tcb0->TickNextPtr = Ptcb; 

110 p tcbl->TickPrevPtr = p tcb; 

式 浊 得 } 

112 // 退出 循环 

113 p tcbl = (OS TCB *)0; 

114 } 

115 } 

116 // 更 新 数组 双向 链表 的 任务 控制 块 个 数 

117 p_spoke->NbrEntriest+; 

18 } 

119 // 更 新 数组 元 素 上 的 最 大 任务 控制 块 个 数 

120 if (P_spoke->NbrEntriesMax < p_ spoke->NorEntries) { 
121 p_spoke->NbrEntriesMax = p_spoke->NbrEntries; 
122 } 

123 // 任务 控制 块 也 指向 数组 元 素 指针 

124 p_tcb->TickSpokePtr = p_spoke; 

125 he = OS ERR NONE; 

126 } 





如 果 延 时 选项 是 绝对 延 时 OS_ OPT TIME_MATCH， 意 味 着 现在 开始 延 时 直到 OsTickCtr 等 于 传 入 的 延 时 节拍 数 的 时 候 。OS TICK_TH_RDY 是 一 
个 宏 ， 大 小 是 0xffff0000。tick_delta 为 延 时 到 的 那个 节拍 数 减 去 当前 的 节拍 数 ， 如 果 这 个 数 大 于 0xffff0000， 以 时 钟 节拍 1000Hz 为 例 ， 延 时 时 间 达 


到 49 天 ， 一 般 来 说 这 是 不 可 能 的 ， 这 种 情况 更 多 的 是 延 时 到 的 那个 节拍 数 小 于 当前 的 节拍 数 ， 这 涉及 无 符号 数 相 减 的 相关 知识 。 延 时 到 的 那个 节拍 数 
小 于 当前 的 节拍 数 ， 则 返回 错误 。 

当 延 时 选项 是 周期 性 延 时 OS OPT TIME_PERIODIC 的 时 候 ， 任 务 控制 块 的 元 素 TickCtrPrev 如 果 小 于 当前 的 节拍 数 加 1， 则 延 时 到 的 节拍 数 就 是 
TickCtrPrev 和 要 延 时 的 节拍 数 之 和 和， 否则 就 是 当前 的 节拍 数 和 要 延 时 的 节拍 数 之 和 。 分 析 第 31 行 不 等 式 的 时 候 ， 可 以 将 第 30 行 和 第 29 行 的 等 式 带 
入 ， 这 决定 了 在 周期 性 延 时 中 不 会 因 系统 负 担 过 重 而 导致 延 时 时 间 变 长 。 我 们 来 对 比 下 列 代码 清单 3-5 中 两 段 除 选项 不 同 之 外 的 延 时 。 


代码 清单 3-5 ”周期 性 延 时 对 比 相对 延 时 














for (i=0; i<10; i++) 
{ 
} 


OSTimeDly (2,0S_ OPT _ TIME PERIODIC, &err); 














for (i=0; i<10; i++) 
{ OSTimeDly (2,0S OPT TIME DLY, &err); 

} 

如 图 3-3 所 示 ， 当 系统 负担 过 重 的 时 候 ， 相 对 延 时 可 能 会 相差 多 个 节拍 ， 但 是 周期 性 延 时 会 进行 相应 的 调整 。 
如 果 是 相对 延 时 模式 ， 直 接 将 要 延 时 的 节拍 数 加 上 当前 的 节拍 数 就 是 要 延 时 到 的 节拍 数 。 


上 面 根据 不 同 的 延 时 选项 计算 好 了 要 延 时 的 时 间 ， 下 面 开 始 将 当前 任务 插入 就 绪 列表 。 根 据 前 面 讲 到 的 哈 希 算法 ， 首 先 计算 要 延 时 到 的 节拍 数 对 
常数 OSCfg_TickWheelSize， 然 后 根据 余数 取出 OSCfg_TickWheel 中 相应 的 数组 元 素 。 接 下 来 讲解 插入 过 程 ， 大 家 最 好 先 回顾 图 2-1 及 节拍 列表 的 数 
据 结构 内 容 。 


突然 系统 负担 过 重 ， 这 
时 本 来 该 继续 延 时 ， 但 是 
CPU 被 其 他 任务 占用 , 直 
到 这 个 节拍 结束 





相对 延 时 ”节拍 数 


某 个 时 刻 任务 延 时 2 个 节 1 个 节拍 后 继续 相对 延 
开始 延 时 结束 时 2 个 节拍 ， 但 是 这 时 已 
经 相差 别 了 1 个 节 





突然 系统 负担 过 重 ， 这 
时 本 来 该 继续 延 时 ， 但 是 
CPU 被 其 他 任务 占用 ， 直 


到 这 个 节 担 结束 





周期 性 延 时 节拍 数 







某 个 时 刻 任务 延 时 2 个 节 1 个 节拍 后 继续 延 时 ， 这 

开始 延 时  ” 拍 结 束 时 周期 性 延 时 会 进行 调整 ， 

相对 前 面 记录 在 任务 控制 块 

的 元 素 相 对 延 时 2 个 时 钟 节 
TickCtrP 

拍 ， 此 时 可 以 看 到 并 未 相差 


1 个 节拍 


图 3-3 对比 周 期 性 延 时 和 相对 延 时 


第 65~72 行 表示 数组 元 素 开 始 没有 任何 延 时 或 者 超时 检测 的 任务 ， 先 将 任务 控制 块 组 成 双向 链表 的 变量 TickPrePtr 和 TickNextPtr 都 置 0， 再 将 数 
组 元 素 中 指向 第 一 个 任务 控制 块 的 指针 指向 当前 插入 的 任务 控制 块 ， 如 图 3-4 所 示 。 这 个 过 程 就 是 双向 链表 插入 第 一 个 的 过 程 。 图 3-4 中 的 步骤 @ 对 应 
第 117 行 ， 对 节拍 列表 插入 的 任务 个 数 加 1; 步骤 @ 对 应 第 96 行 。 不 管 任务 怎么 插入 节拍 列表 ， 最 后 任务 控制 块 的 元 素 TickSpokePtr 都 要 指向 其 插入 
的 数组 元 素 OSCfg_TickWheel[spoke]， 这 样 方便 在 删除 节点 的 时 候 知道 这 个 任务 是 插入 哪个 数组 元 素 中 。 


第 74~111 行 表示 元 素 之 前 已 经 有 任务 控制 块 ， 因 为 后 面 插入 的 任务 要 按照 延 时 到 的 节拍 数 顺 序 插入 ， 如 图 3-5 所 示 。 越 快 到 期 的 任务 就 越 排 在 前 
面 。 从 前 面 先 到 期 的 任务 开始 一 个 个 取出 来 放 入 pP_tcb1 变 量 ， 每 取出 一 个 任务 控制 块 P_tcb1， 就 跟 要 插入 的 任务 控制 的 剩 下 节拍 数 TickRemain 进 行 
比较 。 比 较 结果 会 出 现 三 种 情况 。 


1) 如 果 当 前 任务 剩 下 的 节拍 数 大 于 取出 任务 ， 而 且 取 出 的 任务 不 是 最 后 一 个 元 素 ， 第 88 行 就 继续 找 出 下 一 个 任务 在 循环 里 进行 比较 。 


2) 如 果 当 前 任务 剩 下 的 节拍 数 大 于 取出 的 任务 ， 且 取出 任务 是 双向 列表 最 后 一 个 元 素 ， 那 么 直接 插入 后 面 就 可 。 这 个 过 程 很 简单 ， 第 92~ 94 行 
分 别 对 应 图 3-5 中 的 @、@、@ 操 作 。 


3) 如 果 当 前 任务 剩 下 的 节拍 数 小 于 或 等 于 当前 的 ， 那 么 直接 插入 比较 的 那个 任务 的 前 面 。 这 个 插入 过 程 还 可 以 分 为 : 如 果 插 入 在 最 前 面 ， 那 么 
是 第 101~ 104 行 那样 的 操作 ， 图 3-6 分 解 了 插入 的 整个 过 程 ; 如 果 插 在 中 间 ， 如 第 106~110 行 ， 图 3-7 解 析 了 整个 过 程 。 
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TickCtrMatch 
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MsgSize 
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PendOn 
TickSpokePtr 
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图 3-4 ”节拍 列表 插入 第 一 个 元 素 


操作 前 OSCfe_TickWheel[spoke] 
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图 3-5 ”任务 插入 节拍 列表 最 后 
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图 3-6 ”任务 插入 节拍 列表 最 前 面 


TS 





OS_TICK SPOKE 









操作 前 OSCfg_TickWheel[spoke] 
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OS_TCB OsS_TCB 
04 TickPrevPtr TickPrevPtr 
TickNextPtr TickNextPtr| 0 
TickRemain TickRemain 
TickCtrMatc TickCtrMatch 
TaskState TaskState 
TS TS 
MsgPtr MsgPtr 
MsgSize MsgSize 
PendStatus PendStatus 
PendOn PendOn 
TickSpokePtr TickSpokePtr 
其 他 元 素 其 他 元 素 
OS_TICK SPOKE 
| FirstPtr 
操作 顺序 OSCfe_TickWhegl[spoke] @ 
NbrEntrMax OS TCB OS TCB OS TCB 
. TickPrevPtr TickPrevPtr pe 
TickNextPtr TickNextPtr ——— TickNextPtr 
TickRemain © | TickRemain | 
TickCtrMatch |TickCuMatch |TickCtrMateh 
TaskState TaskState TaskState 
TS 
MsgPtr 
MsgSize MsgSize | MsgSize | 
PendStatus | pendStatus | 
TickSpokePtr TickSpokePtr 
其 他 元 素 其 他 元 素 





图 3-7 任务 插入 节拍 列表 中 间 


插入 过 程 其 实 就 是 双向 链表 的 插入 过 程 ， 请 读者 自行 查看 图 和 代码 进行 理解 。 


3.4 ”任务 取消 延 时 


OSTimeDlyResume 函 数 用 于 取消 其 他 任务 的 延 时 。 注 意 这 里 是 其 他 任务 ， 因 为 任务 一 旦 处 于 延 时 状态 ， 就 被 剥夺 CPU 使 用 权 ， 无 法 自己 取消 延 





















时 。 就 像 上 有 人 被 关 进 监狱 ， 想 要 出 来 ， 就 一 定 要 外 面 的 人 采取 办 法 解救 。 如 果 任 务 既 被 延 时 又 被 挂 起 ， 即 任务 处 于 


OS TASK_STATE_DLY_SUSPENDED 的 状态 ， 昌 然 可 以 恢复 被 延 时 的 状态 ， 但 是 仍然 被 挂 起 ， 则 要 除去 挂 起 后 任务 才能 就 绪 。 这 有 点 像 一 个 犯人 犯 








了 两 条 不 同 的 罪 ， 昌 然 他 的 律师 帮 他 洗 清 了 其 中 一 条 罪 ， 但 犯人 还 是 得 进 监狱 。 


参数 


(1) p_tcb: 要 被 恢复 延 时 的 函数 。 


(2) p_err: 指向 返回 错误 类 型 的 指针 ， 主 要 有 以 下 几 种 类 型 。 


. OS_ERR_NONE 没有 错误 


OS_ERR_STATE_INVALID 任务 状态 不 可 用 ， 可 能 是 已 经 被 删除 


. OS_ERR_TIME_DLY_RESUME,_ISR 在 中 断 中 调用 恢复 函数 





“ OS_ERR_TASK_SUSPENDED 任务 解除 了 延 时 状态 ， 但 是 仍然 被 挂 起 


. OS_ERR_TIME_NOT_DLY 任务 没有 在 延 时 


OSTimeDlyResume 函 数 的 具体 代码 如 代码 清单 3-6 所 示 。 


代码 清单 3-6 OSTimeDlyResume 函 数 
















































































1 #if OS CFG TIME DLY RESUME EN > 0u 

2 void OSTimeDlyResume (OS TCB *p tcb, 
3 OS ERR *p err) 
4 1 

5 CPU SR ALLOC () ; 

6 

1 

8 

9 #ifdef OS SAFETY CRITICAL 

10 if (p err == (OS ERR *)0) { 

不 站 OS SAFETY CRITICAL EXCEPTION (); 
12 return; | 

13 } 

14 #engdif 

15 

16 // 不 能 在 中 断 中 调用 中 断 恢复 函数 

17 #if OS CFG CALLED FROM ISR CHK EN > 0u 
18 if (OSIntNestingCtr > (OS NESTING CTR) Ou) { 
19 *p err = OS ERR TIME DLY RESUME, ISR; 
20 return; 
21 } 
22 #endif 
23 
24 #if OS CFG ARG CHK EN > 0u 
25 if (p tcb = (OS TCB *)0) { 
26 *p err = OS ERR TASK NOT DLY; 
27 returriy 
28 } 
29 #endif 

30 

31 CPU_ CRITICAL ENTER(); 

32 // 检查 任务 状态 

33 switch (p tcb->TaskState) { 

34 // 任务 处 于 就 绪 状 态 ， 退 出 

35 Case OS_TASK STATE RDY: 

36 CPU_CRITICAL EXIT(); 

S37 *p err = OS ERR TASK NOT DLY; 
38 break; 

39 

40 // 延 时 状态 

41 case OS_ TASK STATE DLY: 

42 OS CRITICAL ENTER CPU CRITICAL EXIT(); 
43 Pp_ tcb->TaskState = OS TASK STATE RDY; 
44 // 脱离 节拍 列表 

45 OS TickListRemove (p tcb); 

46 // 插入 就 绪 列表 

47 OS RdyListInsert (p tcb); 

48 OS CRITICAL EXIT NO SCHED(); 
49 *p_ err = OS ERR NONE; 
50 break; 
ST 
52 // 等 待 状态 ， 退 出 
53 case OS_TASK STATE PEND: 
54 CPU_ CRITICAL EXIT(); 
| *p err = OS ERR TASK NOT DLY; 
56 break; 
57 
58 // 有 超时 限制 的 等 待 状态 ， 退 出 
59 case OS_ TASK STATE PEND TIMEOUT: 
60 CPU CRITICAL EXIT(); 

61 *p err = OS ERR TASK NOT DLY; 
62 break; 

63 

64 // 挂 起 状态 ， 退 出 


65 case OS TASK STATE SUSPENDED : 












































66 CPU ( CRITICAL ,EXIT () ， 

和 了 *p err = OS ERR TASK NOT DLY; 

68 break; 

69 

70 // 挂 起 、 延 时 状态 ， 解 除 延 时 状态 

3 case OS _ TASK STATE DLY SUSPENDED: 

72 OS CRITICAL ENTER CPU CRITICAL EXIT(); 
73 p tcb->TaskState = OS TASK STATE SUSPENDED; 
74 OS_TickListRemove (p tcb); 

a OS CRITICAL EXIT NO SCHED(); 

76 WP er = OS ERR _ TASK SUSPENDED; 
77 break; 加 

78 

79 // 等 待 、 挂 起 状态 

80 Case OS_ TASK STATE PEND SUSPENDED: 

81 CPU ( CRITICAL , EXIT (); 

82 *p err = OS ERR TASK NOT DLY; 

83 break; 

84 

85 // 有 超时 限制 的 等 待 、 挂 起 状态 

86 case OS TASK STATE PEND TIMEOUT SUSPENDED: 
87 CPU CRITICAL EXIT(); 

88 *p err = OS ERR TASK NOT DLY; 

89 break; 

90 

91 // 其 他 状态 ， 可 能 是 任务 已 经 被 删除 

92 default: 

93 CPU_CRITICAL EXIT(); 

94 *p err = OS ERR STATE INVALID; 

95 break; 

96 } 

97 // 任务 调度 

98 OSSched (); 

99: } 

100 #engdif 





We 处 理 的 任务 只 有 OS TASK _ STATE_DLY 和 OS TASK STATE _DLY SUSPENDED。 前 者 退出 节拍 列 
表 后 进入 就 绪 列 表 ; 后 者 退出 节拍 列表 后 继续 被 挂 起 ， 最 后 进行 任务 调度 ， 如 果 任 务 已 经 恢复 就 绪 状 态 ， 且 优先 级 足够 高 ， 就 会 获得 CPU 使 用 权 。 


3.5 “任务 脱离 节拍 列表 


任务 脱离 节拍 列表 函数 OS_TickListRemove 的 具体 代码 如 代码 清单 3-7 所 示 。 


代码 清单 3-7 ”将 任务 脱离 节拍 列表 函数 OS_TickListRemove 











1 void OS TickListRemove (OS TCB *p tcpb) 

2 { 

3 OS _ TICK SPOKE *p spoke; 

4 OS_TCB *p tcbl; 

5 OS_TCB xD tob2; 

6 

7 

8 // 很 方便 就 找到 了 任务 控制 块 是 哪个 元 素 的 双向 链表 

:| p_spoke = p tcb->TickSpokePtr; 

10 if (p.: spoke != (OS TICK SPOKE *)0) { 

11 /7 清空 剩 下 的 个 数 

12 p_ tcb->TickRemain = (OS _ TICK) Ou; 

13 // 查看 要 移 除 的 任务 控制 块 是 否 在 双向 链表 的 最 前 面 
14 if (p spoke->FirstPtr == p tcb) { 

43 p_tcbl = (OS_ TCB *)p tcb->TickNextPtr; 
16 p_spoke->FirstPtr = P tcbl; 

bg if (p tcbl != (OS TCB *)0) { 

18 p tcb1l->TickPrevPtr = (void *)0; 
19 } 

20 } else { 

21 p_tcbl = p tcb->TickPrevPtr; 
22 p_tcb2 = p tcb->TickNextPtr; 
23 p_tcbl->TickNextPtr = p tcpb2; 

24 if (p tcb2 != (OS TCB *)0) { 

25 p_ tcb2->TickPrevPtr = p tcbl; 

26 } 

27 

28 思 任务 控制 块 的 相关 元 素 都 清 零 

29 Pp tcb->TickNextPtr = (OS TCB *) 0; 
3 Pp tcb->TickPrevPtr = (OS TCB *) 0 
31 p tcb->TickSpokePtr = (OS TICK SPOKE *)0; 
32 p tcb->TickCtrMatch = (OS TICK ) Ou; 
33 /7 双向 链表 任务 控制 块 个 数 减 ] 

34 Pp_spoke->NbrEntries-——; 

35 } 

36 站 





函数 OS_TickListRemove 用 于 将 任务 脱离 节拍 列表 ， 这 个 过 程 就 是 双向 链表 脱离 其 中 一 个 节点 的 过 程 。 首 先 判断 要 删除 的 任务 控制 块 是 否 是 节拍 


列表 的 第 一 个 任务 控制 块 : 如 果 是 ， 操 作 顺 序 如 图 3-8 所 示 ; 如 果 不 是 双向 链表 的 第 一 个 任务 ， 操 作 顺 序 如 图 3-9 所 示 。 
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TickNextPtr TickNextPtr —> 0 
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TaskState TaskState 
TS TS 
MsgPtr MsgPtr 
MsgSize MsgSize 
PendStatus PendStatus 
PendOn PendOn 
TickSpokePtr TickSpokePtr 
其 他 元 素 其 他 元 素 
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图 3-8 ”任务 从 双向 链表 前 面 脱 高 
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图 3-9 ”任务 从 双向 链表 中 间或 者 后 面 脱离 


脱离 节拍 列表 就 是 双向 链表 移 除 节点 的 过 程 。 


3.6 ”获取 和 设置 时 钟 节拍 


获取 时 钟 节拍 函数 OSTimeGet 的 源码 如 代码 清单 3-8 所 示 。 


代码 清单 3-8 ”OSTimeGet 函 数 





1 OS TICK OSTimeGet (OS ERR *p err) 


{ 
OS TICK ticks; 
CPU SR ALLOC(); 


#ifdef OS SAFETY CRITICAL 
if (P err == (OS PRR *)0) { 
OS SAFETY CRITICAL EXCEPTION (); 
return ((OS TICK) 0); 





} 
#endif 


CPU_CRITICAL ENTER(); 
ticks = OSTickCtr; 
CPU CRITICAL EXIT(); 
*p err = OS ERR NONE; 
return (ticks); 
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MD 


设置 时 钟 节拍 函数 OSTimeGet 的 源码 如 代码 清单 3-9 所 示 。 


代码 清单 3-9 ”OSTimeSet 函 数 








1 voiqd OsSTimeSet (OS TICK ticks, 
县 OS_ERR #1 EE) 
314 

4 CPU SR ALLOC(); 

与 

6 

TF 

8 #ifdef OS SAFETY CRITICAL 

9 if (P err == (OS ERR *)0) { 
10 OS_SAFETY ( CRITICAL , EXCEPTION (); 
1 return; 

2 } 

3 #engif 

4 

与 CPU_ CRITICAL ENTER () 

6 OSTickCtr = ticks; 

CPU_ CRITICAL EXIT(); 

8 *]i EEE = OS ERR NONE; 

9} 





OsTimeGet 和 OSTimeset 这 两 个 函数 使 用 起 来 和 理解 起 来 是 非常 容易 的 ， 直 接 调 用 得 到 返回 值 即 是 节拍 数 ， 输 入 参数 即 可 设置 节拍 数 。 函 数 就 
是 修改 全 局 变量 OSTickCtr 的 值 。 平 常 我 们 也 可 以 直接 操作 全 局 变量 OSTickCtr 的 值 ， 但 要 和 函数 一 样 加 上 临界 段 保护 才 可 以 。 


3.7 HC/OS-lll 全 局 变量 的 定义 和 声明 


本 节 讲 解 的 内 容 跟 时 钟 节拍 没有 多 大 关系 。 因 为 OSTickCtr 是 一 个 全 局 变量 ， 所 以 这 里 顺便 介绍 uC/OS-lll 全 局 变量 的 定义 和 声明 。HC/OS- 趾 由 
很 多 全 局 变量 来 记录 各 种 事情 。 不 知道 大 家 有 没有 观察 到 ，HC/OS-lll 中 全 局 变量 的 定义 和 声明 没有 分 开 ， 只 用 了 一 处 ， 如 下 : 





中 


OS_EXT ”数据 类 型 ”全 局 变 


如 果 使 用 MDK 编 译 器 ， 无 论 是 找到 定义 还 是 声明 的 地 方 ， 都 是 一 个 地 方 。 常 规 的 办 法 是 ， 无 法 做 到 定义 一 个 就 可 以 在 多 个 C 文 件 使 用 的 全 局 变 
量 。 一 个 变量 想 要 在 其 他 的 C 文 件 中 同样 适用 ， 需 要 其 他 的 C 文 件 再 次 声明 这 个 变量 或 者 要 包含 这 个 变量 声明 的 .h 文 件 ， 才 能 在 其 他 的 C 文 件 中 一 起 使 

















首先 在 uC/OS-lll 的 OS.H 文 件 中 可 以 看 到 OS_EXT 的 定义 代码 段 ， 如 代码 清单 3-10 所 示 。 


代码 清单 3-10 ”全 局 变量 相关 代码 段 


1 #ifdef OS GLOBALS 

2 #define OS EXT 

3 #else 

4 #define OS EXT extern 
5 #engif 


这 段 代码 从 C 语 言 的 规则 上 看 就 是 ， 当 文件 中 定义 OS_GLOBALS 时 ,我们 将 OS_EXT 表 示 为 空 ， 那 么 编译 器 给 这 个 文件 夹 中 每 个 用 OS_EXT 修 饰 的 
量 分 配 内 存 空间 。 为 了 说 明 方 便 ， 我 们 用 具体 指 变 量 OSIntQTaskTCB 来 说 明 ， 在 OS.H 中 有 : 


OS EXT OS_TCB OSIntQTaskTCB; 


如 果 其 他 的 文件 夹 没有 定义 OS_GLOBALS， 就 相当 于 在 OSIntQTaskTCB 前 面 加 了 extern， 这 样 就 只 是 声明 了 一 个 全 局 变量 并 没有 分 配 空间 。 


如 果 仅 在 一 个 .C 文 件 中 定义 OS_GLABALS， 其 他 的 C 文 件 不 定义 OS_GLABALS， 并 且 所 有 的 .C 文 件 都 包含 (不管 是 直接 还 是 间接 ) 文件 OS.H， 那 
么 OSIntQTaskTCB 实 际 上 在 包含 OS_GLABALS 的 .C 文 件 中 就 是 变量 的 定义 ， 而 其 他 的 C 文 件 只 是 变量 的 声明 ， 这 样 就 定义 了 一 个 全 局 变量 ， 而 且 不 
会 产生 重复 定义 的 错误 。 


注 : 间接 包含 H 文 件 ， 即 A 如 果 包 含 B，B 包 含 C， 那 么 A 也 同样 包含 C。 
为 了 更 好 地 理解 ， 我 们 将 以 下 语句 中 的 OS_EXT 删 掉 ， 编 译 会 出 现 什 么 情况 呢 ? 


OS EXT OS_TCB OsSIntQTaskTCB; 


没有 去 掉 OS_EXT 之 前 ，hC/OS 就 将 全 局 变量 OSIntQTaskTCB 的 OS.H 中 定义 ， 在 包含 OS.H 的 其 他 文件 中 声明 。 将 OS_EXT 去 掉 就 变 成 在 包含 
OS.H 的 其 他 文件 中 ， 所 以 会 出 现 重复 定义 。 由 于 多 个 C 文 件 包含 OS.H， 所 以 重复 定义 的 错误 有 多 个 。 


如 果 把 上 面 的 语句 改 成 下 面 的 语句 呢 ? 


OS EXT OS TCB OSIntoTaskTCB=0; 


同样 地 ， 会 出 现 重复 定义 的 情况 ， 因 为 externOS_ TCB OSIntQTaskTCB=0; 已 经 不 只 是 声明 那么 简单 ， 而 是 定义 。 


HC/OS 主 要 是 利用 .h 文 件 的 包含 和 条 件 编译 ， 让 相同 的 语句 以 定义 变量 和 声明 变量 两 种 不 同 的 情况 出 现在 不 同 的 文件 中 ， 这 样 就 顺利 地 完成 全 局 
变量 的 定义 和 声明 。 在 平时 的 编程 中 ， 如 果 需 要 定义 一 些 全 局 变量 在 多 个 C 文 件 中 ， 则 可 以 采用 这 种 条 件 编译 和 .h 文 件 包含 的 做 法 。 


3.8” 忆 结 


AGN2 口 


本 章 讲 解 了 延 时 函数 的 使 用 ， 以 及 它们 的 原理 。 调 用 延 时 函数 的 本 质 就 是 ， 先 将 任务 插入 节拍 列表 ， 再 进行 任务 切换 让 其 他 的 任务 运行 ;接着 节 
拍 列表 就 会 在 时 钟 节拍 到 来 的 时 候 管理 这 些 任 务 ， 并 快速 处 理 到 期 的 任务 。 处 理 的 时 候 还 要 检查 任务 的 状态 是 否 跟 延 时 有 关 ， 如 果 任 务 单纯 只 是 延 时 
状态 ， 那 么 直接 将 任务 脱离 节拍 列表 后 就 可 以 就 绪 ; 如 果 任 务 不 只 是 延 时 状态 ， 还 有 挂 起 状态 ， 脱 离 节拍 列表 后 还 需要 处 于 挂 起 状态 。 任 务 脱离 和 插 
入 节拍 列表 其 实 是 一 个 非常 简单 的 双向 链表 的 脱离 和 插入 过 程 ， 这 个 过 程 用 到 了 哈 希 算法 。 除 了 自然 到 期 之 外 ， 还 可 以 调用 函数 OSTimeDlyResume 
解除 任务 的 延 时 状态 ， 相 当 于 反悔 一 “ 算 了 ， 不 要 让 任务 XXX 再 继续 延 时 了 ” ， 其 中 任务 XXX 是 除 调用 函数 OSTimeDlyResume 之 外 的 任务 。 


第 4 章 ”软件 定时 器 


软件 定时 器 是 建立 在 硬件 定时 器 的 基础 上 而 开发 的 ， 只 要 设置 一 个 硬件 的 定时 器 ， 通 过 软件 分 频 和 系统 的 管理 即 可 得 到 多 个 软件 定时 器 ， 甚 至 是 
无 限 多 个 软件 定时 器 ， 不 过 精度 肯定 会 下 降 ， 玩 过 单片机 的 可 能 都 有 写 过 这 样 功能 的 代码 ， 只 不 过 不 是 很 系统 ， 也 没有 将 它 称 为 软件 定时 器 ， 像 前 面 
的 时 间 片 轮 询 法 其 实 也 可 以 叫做 软件 定时 器 ， 因 为 它 可 实现 让 多 个 任务 定时 执行 的 功能 。hC/Os- 员 的 软件 定时 器 就 是 在 系统 节拍 的 基础 上 分 频 得 到 
的 。 如 果 要 使 用 软件 定时 器 的 功能 ， 就 必须 将 OS_CFG_TMR_EN 置 1。 





本 章 会 仔细 讲解 xXC/OS-lll 的 软件 定时 器 的 相关 数据 结构 一 一 定时 器 列表 和 定时 器 内 部 运行 的 机 制 |。 


4.1 实例 演示 


下 面 创建 一 个 
不 过 我 们 只 建立 了 一 个 


关键 代码 如 代码 清单 4-1 所 示 ， 可 以 看 到 其 实 创建 一 个 


定时 器 并 利用 时 间 戳 统计 出 定时 的 时 间 。 如 图 4-1 所 示 ， 我 们 用 串口 打印 出 了 测试 的 相关 信息 ， 可 以 看 到 定时 器 还 是 相当 准确 的 ， 
定时 器 ， 有 兴趣 的 同学 可 以 多 建立 几 个 


定时 器 看 看 精度 会 不 会 下 降 ， 应 该 是 略 有 下 降 ， 但 是 不 会 下 降 太 多 。 


司 忆 
， 只 需 


定时 器 需要 知道 的 知识 并 不 多 要 知道 怎么 去 调用 一 个 定时 器 相关 函数 即 可 ， 如 果 操 











作 的 是 硬件 定时 器 ， 那 么 很 多 时 候 要 查 数据 手册 查 很 久 ， 而 且 HhC/OS-I 咱 可 以 创建 很 多 个 定时 器 ， 硬 件 定时 器 个 数 通 常 是 十 分 有 限 的 。 
代码 清单 4-1 ”创建 定时 器 
1 void Task Tmr (void *p arg) 
2 { 
3 OS_ ERR err; 
4 
5 // 定时 器 变量 
6 OS_TMR MyTmr; 
了 (void)p arg; 
8 
9 // 创建 定时 器 
10 OSTmrCreate ((OS_ TMR *) gEMyTmr, 
4 (CEU 4 CHAR *) "MyTimer", 
12 (OS TICK }1i00. 
13 // 第 一 次 延 时 设置 为 100， 结 合 定时 器 的 频率 是 100Hz， 正 好 1S 
14 (OS TICK OU 
15 // 重复 延 时 的 时 候 100 个 rmrTick， 结合 定时 器 的 频率 是 100Hz， 正 好 1s 
16 (OS_OPT )OS_OPT TMR PERIODIC,// 模式 设置 为 重复 模式 
1 了 (OS TMR CALLBACK PTR ) CDbOfTmr1， // 回调 函数 
18 (void x) 0， // 参数 设置 为 0 
19 (OS_ERR *)err); 
20 
21 // 启动 定时 器 
22 OSTmrStart ((OS TIMR  *)&MyTmr, 
过 本 (OS_ERR *)err); 
24 
25 // 保存 定时 器 开始 的 时 候 的 时 间 和 惟 
26 ts_ start = OS TS GET(); 
27 
28 while (1) { 
29 // 不 断 阻塞 
30 OSTimeD1yHMSM (0, 0,1,0, OS_OPT TIME HMSM STRICT, &err); 
31 
32 } 


几 ) 野 火 多 功能 调试 助手 V0.2.0， S99 
赴 口 调试 功能 | GSM 调 试 功能 | GPS 定位 功能 | 交流 学 习 


COM3 NN 
定时 1s ， 时 间 戳 测试 : 995713 


ri 定时 1s ， 时 间 锥 测试 : 995732 
RE 定时 1s ， 时 间 蕉 测试 : 995713 
定时 1s ， 时 间 葵 测试 : 995713 
定时 1s ， 时 间 葵 测试 : 995713 
定时 1s ， 时 间 铃 测试 : 995715 
定时 1s ， 时 间 戳 测试 : 995713 
定时 1s ， 时 间 崔 测试 : 995713 


定时 1s ， 时 间 书 测试 : 995713 








加 自动 发 送 。 癌 ] 十 六 进 制 发 送 


三 


文件 路 径 | 还 没 选择 要 发 送 的 文件 





串口 已 开启 接收 字 节 数 : 297 。 发 送 字 节 数 : 计数 清 季 | 





图 4-1 串口 打印 定时 测试 结果 


OSsTmrCreate() 函 数 用 来 创建 一 个 定时 器 ， 但 是 创建 一 个 定时 器 并 不 代表 创建 完 就 开始 运行 ， 而 是 要 调用 函数 OSTmrstart() 来 启动 。 下 面 讲解 定 
时 器 创建 函数 OSTmrCreate() 的 使 用 。 


其 参数 含义 如 下 。 
1) p_tmr: 用 户 自 定义 的 定时 器 变量 
2) p_name: 用 户 可 以 给 定时 器 起 一 个 名 字 ， 方 便 调 试 。 


3) opt: 可 以 为 OS_OPT TMR_ ONE SHOT 或 者 OS OPT TMR_PERIODIC，OS OPT TMR_PERIODIC 为 重复 的 ，OS OPT TMR_ ONE SHOT 
是 一 次 性 的 。 

4) dly: 如 果 上 面 的 选项 是 OS_OPT_TMR_ONE_SHOT， 那 么 dly 就 是 这 个 定时 器 定时 的 时 间 。 如 果 选 项 是 OS_OPT_TMR _PERIODIC, 而 且 dly 
不 为 0， 则 第 一 次 延 时 的 时 间 就 是 dly。 

5) period: 如 果 选 项 是 ODS OPT_ TMR_PERIODIC， 那 么 第 一 次 过 后 每 次 定时 的 时 间 都 是 period 这 么 长 。 而 且 如 果 选 项 是 


OS_OPT_ TMR_PERIODIC 且 dly 是 0， 那 么 定时 器 第 一 次 延 时 的 时 间 也 是 period。 


上 面 的 dly 和 period 的 单位 是 由 宏 OS_ CFG_TMR_TASK_RATE_HZ 决 定 的 ， 我 们 在 例 程 中 都 设置 为 100， 也 就 是 说 ， 定 时 器 的 单位 是 10ms。 一 般 
设置 0S CFG_ TMR_TASK_RATE_HZ 是 时 间 节 拍 的 整数 倍 ， 因 为 O9 CFG_ TMR_TASK_RATE_HZ 是 由 时 间 节 拍 分 频 而 来 的 ， 没 有 设置 为 整数 倍 会 导 至 
定时 器 定时 不 准确 。 





6) p_callback: 回调 函数 指针 。 定 时 器 每 次 到 期 的 时 候 都 可 以 执行 指定 的 回调 函数 ， 可 以 在 创建 的 时 候 设 置 ， 回 调 函 数 跟 我 们 前 面 讲 到 的 钩子 
函数 有 很 大 的 相似 处 。 回 调 函 数 一 个 很 好 的 定义 如 下 。 “回调 函数 是 由 用 户 撰写 ， 而 由 操作 系统 调用 的 一 类 函数 ， 回 调 函 数 可 以 把 调用 者 和 被 调用 者 





分 开 ， 调 用 者 (例如 操作 系统 ) 不 需要 关心 被 调用 者 到 底 是 哪个 函数 ， 它 所 知道 的 就 是 有 这 么 一 类 函数 ， 这 类 函数 满足 相同 的 函数 签名 (函数 原型 ， 
参数 ， 返 回 值 等 ) ， 用 户 书写 完毕 后 再 被 调用 就 可 以 了 。 一 般 来 讲 : 回调 函数 都 是 基于 某 种 消息 驱动 的 ， 要 在 获取 相应 消息 时 调用 该 函数 ， 你 只 要 把 











函数 写 好 并 把 地 址 传 过 去 就 行 ， 至 于 如 何 调用 你 的 函数 ， 那 你 不 需要 管 ， 调 用 部 分 的 代码 不 是 你 写 的 .“ 


7) p_callback_arg: 回调 函数 传递 的 参数 。 


8) p_err: 指向 返回 错误 类 型 的 指针 ， 主 要 有 以 下 几 种 类 型 。 


. OS_ERR_NONE: 没有 错误 。 


: OS_ERR_ILLEGAL_ CREATE_RUN_TIME: 在 定义 DSSafetyCtiticalStattFlag 为 DEF_ TRUE 后 就 不 运行 创建 任何 内 核对 象 ， 包 括 软 件 定时 器 


" OS_ERR_OBJ _ CREATED: 该 软件 定时 器 已 经 被 创建 过 了 ， 但 是 函数 中 没有 这 个 错误 相关 代码 。 


" OS_ERR_OBJ_PTR_NULL: 参数 p_tmr 是 个 空 指针 。 


. OS_ERR_OPT_INVALID: 参数 opt 没 有 在 规定 的 范围 内 。 


. OS_ERR_TMR_INVALID_DLY: 创建 的 是 一 次 性 定时 器 ， 但 是 参数 dly 为 0。 





" OS_ERR_TMR_INVALID_PERIOD: 创建 的 是 周期 性 定时 器 ， 但 是 参数 petoid 为 0。 





- OS_ERR_TMR_ISR: 在 中 断 中 创建 定时 器 。 


定时 器 创建 函数 OSTmrCrente() 的 源码 如 代码 清单 4-2 所 示 。 


代码 清单 4-2 ”创建 定时 器 函数 OSTmrCreate() 
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voidq OSTmrCreate (OS TMR *p: tmre; 
CPU CHAR *p_name, 
OS TICK dly; 
OS_ TICK period, 
OS_OPT opt, 
OS TMR CALLBACK PTR p callback, 
void *p_callback arg, 
OS_ERR SE) 
{ 
CPU_SR_ALLOC (); 
#ifdef OS SE CRITICAL 
加 (P err 一 (OS ERR *)0) { 
OS_SAFETY ( CRITICAL , EXCEPTION (); 
return; 
} 
#engdif 
#ifdef OS_SAFETY CRITICAL IEC61508 
if (OSSafetyCriticalStartFlag == DEF TRUE) { 
*p err = OS ERR ILLEGAL CREATE RUN TIME; 
return; 
} 
#endif 
// 不 允许 在 中 断 中 创建 定时 器 











#if OS CFG CALLED FROM ISR CHK EN > 0u 
if (OSIntNestingCtr > (OS NESTING CTR) 0) { 
*p err = OS ERR TMR ISR; 
return; 
} 
#engdif 
// 参数 检测 
#if OS CFG ARG CHK EN > 0u 
和 (p - tmr 一 (OS ， TMR *)0) { 
*p err = OS ERR OBJ PTR NULL; 
return; 


} 


// 检查 延 时 时 间 是 否 为 0 

Switch (opt) { 

// 周期 性 延 时 只 要 周期 参数 Period 不 为 0 即 可 
case OS_ OPT TMR | PERTODIG: 





if (period == (OS TICK)O0) { 
*p err = os ERR TMR INVALID PERIOD; 
returns 

} 

break; 


// 一 次 性 定时 参数 Gly 不 能 为 0 
case OS OPT TMR ONE SHOT: 


55 if (dly == (OS TICK)0) { 














56 *p err = OS ERR TMR INVALID DLY; 

号 了 return; 

58 } 

59 break; 

60 

61 default: 

62 *p err = OS ERR OPT INVALID; 

63 return; 

64 } 

65 #engif 

66 

67 CPU_ CRITICAL ENTER(); 

68 // 给 定时 器 变量 的 元 素 赋值 

69 P_tmr->State = (OS_STATE )OS_TMR STATE STOPPED; 
// Initialize the timer fields 

70 p_tmr->Type = (OS OBJ TYPE )OS_OBJ TYPE TMR; 

71 p_tmr->NamePtr = (CPU_CHAR *)p_name; 

72 p tmr->Dly = (OS TICK ) daly; 

73 p_tmr->Match = (OS TICK )0; 

74 P_tmr->Remain = (OS_TICK yO 

323 p_tmr->Period = (OS_ TICK )period; 

76 p_tmr->Opt = “(08 OPT )opt; 

了 p_tmr->CallbackPtr = (OS TMR CALLBACK PTR)p callback; 

78 p_tmr->CallbackPtrArg = (void *)p callback arg; 

79 p_tmr->NextPtr = (OS_TMR *) 0; 

80 p_tmr->PrevPtr = (OS_TMR A 

81 

82 // 允许 产生 调试 代码 

83 #if OS CFG DBG EN > 0u 

84 // 将 定时 器 添加 到 调试 的 双向 链表 中 





85 OS_ TmrDbgListAdd (p tmr); 
86 #endif 

87 // 将 记录 定时 器 个 数 的 变量 加 1 
88 OSTmrQty++; 

89 

90 CPU_ CRITICAL EXIT () 7 

91 *p_ err = OS ERR NONE; 

92 J} 


函数 OSTmrCreate() 的 流程 很 简单 ， 都 是 在 初始 化 定时 器 时 变量 的 初始 值 。 


前 面 说 过 ， 除 了 要 创建 定时 器 之 外 ， 还 需要 调用 启动 定时 器 的 函数 OSTmrstart0， 启 动 函 数 OSTmrstart() 仅 仅 需 要 在 参数 输入 已 经 创建 的 定时 
器 的 变量 ， 以 及 存放 错误 类 型 的 指针 即 可 。 错 误 类 型 如 下 。 


OS_ERR_NONE: 没有 错误 。 

. OS_ERR_OBJ TYPE: 参数 p_tmt 没 有 指向 一 个 定时 器 类 型 的 变量 。 

" OS_ERR_TMR_INVALID: 参数 p_tmt 是 空 指针 。 

. OS_ERR_TMR_INACTIVE: 使 用 定时 器 没有 先 初 始 化 ， 即 没有 先 创建 定时 器 ， 也 可 能 是 定时 器 已 经 被 删除 


` OS_ERR_TMR_INVALID_STATE: 定时 器 的 状态 不 可 用 。 








" OS_ERR_TMR_ISR: 企图 在 中 断 中 启动 定时 器 。 


创建 完 必 须要 再 使 用 这 个 函数 才 可 以 运行 定时 器 。 如 果 是 正在 运行 中 的 定时 器 再 调用 启动 函数 ， 就 会 达到 重启 的 效果 。 下 面 首先 介绍 定时 器 的 状 


. OS_TMR_STATE_UNUSED: 定时 器 已 经 被 删除 。 
OS_TMR_STATE_STOPPED: 停止 一 个 定时 器 ， 刚 刚 创建 完 也 是 这 个 状态 。 


. OS_TMR_STATE_RUNNING: 正常 运行 。 





* OS_TMR_STATE_COMPLETED: 定时 完成 ， 一 次 性 的 定时 器 才 会 有 这 种 状态 ， 因 为 重复 性 的 定时 器 不 可 能 自然 地 停止 ， 用 启动 函数 可 以 重新 
启动 。 





定时 器 启动 函数 OSTmrstart() 的 源码 如 代码 清单 4-3 所 示 。 


代码 清单 4-3 ”定时 器 启动 函数 


CPU BOOLEAN OSTmrStart (OS TIMR *p tmr, 
OS_ERR pp SELr) 
{ 


心情 


OS ERR err; 


#ifdef OS_SAFETY CRITICAL 
if (p err = 一 (OS ERR *)0) { 
OS5_SAFETY CRITICAL EXCEPTION () ; 
return (DEF FALSE); 





} 
#endif 


// 不 允许 在 中 断 中 启动 定时 器 
#if OS CFG CALLED FROM ISR CHK EN > Ou 
if (OSIntNestingCtr > (OS NESTING CTR) 0) { 
*p err = OS ERR TMR ISR; 
return (DEF FALSE); 











放生 和 和 
Coo~-umwmmhODoo~aOw 











} 
21 #engdif 
22 
23 // 检查 参数 
24 #if OS CFG ARG CHK EN > 0u 
25 if (p tmr = 一 (O08 TMR *)0) { 
26 *p err = OS ERR TMR INVALID; 
27 return (DEF FALSE) ， 
28 } 
29 #engif 
30 
31 // 检查 内 核对 象 类 型 
32 #if OS CFG OBJ TYPE CHK EN > 0u 
33 if (p tmr->Type != OS OBJ TYPE TMR) { 
34 *p err = OS ERR OBJ TYPE; 
sy return (DEF FALSE); 
36 } 
37 #enqif 
38 // 锁 住 调度 器 
39 OSSchedLock (&err); 


// 根据 定时 器 状态 进行 操作 
switch (p tmr->State) { 
// 定时 器 正在 运行 ， 重 启 
case OS TMR STATE RUNNING: 
[| TmrUnlink (p | tmr); 
OS TmrLink(p tmr, OS OPT LINK DLY); 
OSSchedUnlock (&err); 
*p err = OS ERR NONE; 
return (DEF ， TRUE); 





(心心 心心 心心 心心 心心 
Oo ~ 性 wm 有 口 


// 定时 器 已 经 停止 ,重新 启动 

















51 case OS_TMR STATE STOPPED: 

52 case OS TMR STATE COMPLETED: 

53 OS TmrLink(p tmr, OS OPT LINK DLY); 
54 OssSchedUnlock (&err); 

55 *p_ err = OS ERR NONE; 

56 return (DEF ， TRUE); 

S37 

58 // 定时 器 被 删除 了 ， 返 回 错误 提示 信息 

59 case OS TMR STATE UNUSED: 

60 OsschedUnlock (gerr) ; 

61 *p err = OS ERR TMR INACTIVE; 

62 return (DEF FALSE); 

63 

64 default: 

65 OssSchedUnlock (&err); 

66 *p err = OS ERR TMR INVALID STATE; 
总 了 return (DEF FALSE); 

68 } 

69 1} 





函数 OSTmrStart 源 码 见 代码 清单 4-3。 进 入 函数 OSTmrStart 后 ， 首 先 判 断定 时 器 状态 ， 如 果 定时 器 处 于 运行 的 状态 
OS_TMR_STATE_RUNNING， 则 用 OS_TmrUnlink0 和 OS_TmrLink0 分 别 让 定时 器 脱离 定时 器 列表 和 插入 定时 器 列表 达到 重启 的 效果 。 如 果 停止 或 
者 完成 状态 ， 就 让 定时 器 重新 插入 定时 器 列表 ， 在 停止 或 者 完成 的 时 候 ， 系 统 让 定时 器 脱离 了 定时 器 列表 ， 所 以 使 用 OS_TmrLink0 让 定时 器 重新 插 
入 定时 器 列表 ， 启 动 函数 最 关键 的 还 是 在 OS TmrLink0 和 OS_TmrUnlink(0 这 两 个 函数 ， 这 两 个 函数 分 别 用 来 将 定时 器 变量 插入 定时 器 列表 和 脱离 定 
时 器 列表 中 。 


4.2 ”插入 定时 器 列表 


插入 定时 器 列表 函数 Os TmrLink() 的 源码 如 代码 清单 4-4 所 示 。 


代码 清单 4-4 ”插入 定时 器 列表 函数 OS_TmrLink 








1 void OS TmrLink (OS_TMR *p. tm 
2 OS OPT opt) 

3 { 

4 OS_TMR_SPOKP *p_spoke; 

5 OS_TMR *p tmr0; 




















6 OS_TMR < nr 

7 OS_ TMR SPOKE IX spoke; 

8 

9 

10 // 重 置 定时 器 的 状态 

2 p_tmr->State = OS TMR STATE RUNNING; 

12 /7 如 果 不 是 第 一 次 延 时 ， 则 定时 器 肯定 是 周期 性 定时 器 ， 延 时 时 间 为 Period 
13 if (opt == OS _ OPT LINK PERIODIC) { 

14 P_tmr->Match = p_ tmr->Period + OSTmrTickCtr; 

45 } else { 

16 /* 如 果 dly 是 0， 那 么 定时 器 肯定 是 周期 性 定时 器 ， 周 期 性 定时 器 第 
17 一 次 延 时 时 ， 如 果 ， 0 那么 延 时 时 间 为 Period*/ 

18 if (p tmr->Dly == (OS TICK)0) { 

19 p_ tmr->Match = p tmr->Period + OSTmrTickCtr; 
20 } else { // 如 果 是 非 0， 不管 什么 定时 器 ， 第 一 次 延 时 的 延 时 时 间 肯 定 是 dly 
21 p_ tmr->Match = p tmr->Dly + OSTmrTickCtr; 
22 } 

23 } 

24 

25 // 哈 项 算法 

26 spoke = (OS TMR SPOKE IX) (p tmr->Match $ OSCfg TmrWheelSize); 
27 p_spoke = &OSCfg ， TmrWheel [spoke] ; 

28 

29 // 插入 定时 器 列表 双向 链表 的 过 程 ， 跟 时 钟 节拍 列表 的 过 程 非常 相似 
30 if (p spoke->FirstPtr == (OS TMR *)0) { 

:yh p_tmr->NextPtr = (OS TMR *)0; 

32 有 tmr=>Prevbtr = (OS TMR *)0; 

3 p_spoke->FirstPtr = p tmr; 

34 p_spoke->NbrEntries = 1u; 

35 } else { 

36 p tmr->Remain = p tmr->Match 

37 - OSTmrTickCtre; 

38 p_tmrl = p spoke->FirstPptr; 

39 while (p tmrl != (OS TMR *)0) { 

40 P_tmr1->Remain = p_ tmrl->Match 

41 - OSTmrTickCtr; 

42 if (p tmr->Remain > p tmrl->Remain) { 

43 if (P_tmr1->NextPtr != (OS TMR *)0) { 
44 p_tmrl = p tmrl->NextPtr; 
45 } else { 

46 p_tmr->NextPtr = (OS TMR *)0; 

47 p_tmr->PrevPtr = P tmrl; 

48 p_tmrl->NextPtr = P tmr; 

49 p_tmrl = (OS_ TMR *)0; 
50 } 

S51 } else { 

52 if (p tmril->PrevPtr == (OS TMR *)0) { 
53 p_tmr->PrevPtr = (OS TMR *)0; 

54 p_tmr->NextPtr = p tmrl; 

35 p_tmrl->PrevPtr = p_tmr; 

36 p_spoke->FirstPtr = p_ tmr; 

SY } else { 

58 P_tmr0 = Pp tmrl->Prevetr; 
59 -tine >PEevPtrE = p tmr0; 

60 p_tmr->NextPtr = p_tmrl; 

6 p_tmr0->NextPtr = p_tmr; 

62 p_tmril->PrevPtr = Pp_ tmr; 

63 } 

64 p tmril = (OS TMR *)0; 

65 } 

66 } 

67 p_spoke->NbrEntriest+; 

68 

69 if (p spoke->NbrEntriesMax < p_ spoke->NbrEntries) { 
70 p_spoke->NbrEntriesMax = p_spoke->NbrEntries; 

71 } 

72 } 


当 系 统 中 有 多 个 软件 定时 器 的 时 候 ， 一 个 一 个 检测 是 否 到 期 效率 很 低 ， 有 什么 办 法 让 系统 快速 查找 到 到 期 的 软件 定时 器 ”就 跟 时 间 节 拍 一 样 ， 采 
用 哈 希 算法 。OS_TmrLink() 函 数 将 不 同 的 定时 器 变量 根据 其 对 OSsCfg_ TmrWheelsize 余 数 的 不 同 插入 到 数组 
OsCfg TmrWheel[OS_ CFG TMR_ WHEEL SIZE] 中 去 。 


代码 清单 4-4 的 13~23 行 ， 根 据 参数 opt 选 项 来 设置 本 次 定时 器 到 时 的 时 间 。 如 果 opt 是 Os OPT_LINK_PERIODIC (不 要 跟 定 时 器 的 选项 
OS_OPT_TMR_PERIODIC 搞 混 了 ) ， 说 明 这 不 是 第 一 次 执行 的 定时 器 ， 而 是 一 个 周期 性 定时 器 第 一 次 定时 后 的 定时 器 ， 那 么 下 次 定时 器 到 时 的 时 间 
当然 是 定时 器 的 周期 延 时 值 period 加 上 当前 定时 器 的 计数 值 OSTmrTickCtr。 如 果 是 选项 OS_ OPT_LINK_DLY， 就 再 看 看 定时 器 的 首次 延 时 值 qly 是 否 
为 0， 如 果 为 0， 肯 定 是 周期 性 定时 器 的 第 一 次 定时 ， 因 为 只 有 周期 性 定时 器 才 允 许 dly 为 0。 这 种 情况 就 取 周 期 性 定时 器 的 周期 延 时 值 作为 其 首次 延 时 
值 。 但 是 如 果 首 次 延 时 值 dly 不 为 0， 这 种 情况 重复 定时 器 或 一 次 性 定时 器 都 是 有 可 能 的 ， 不 管 怎么 样 ， 定 时 的 时 间 都 为 dly。 


既然 是 哈 希 算法 ， 开 始 插入 的 时 候 也 要 根据 余数 来 处 理 。 代 码 清单 4-4 的 21~22 行 正 是 如 此 ， 根 据 到 期 时 间 对 OSCfg_TmrWheelSize 的 余数 取出 
OSCfg_TmrWheel[OS_CFG_TMR_WHEEL _SIZE] 中 对 应 的 元 素 。 





定时 器 列表 如 图 4-2 所 示 ， 此 图 主要 的 是 显示 定时 器 变量 在 定时 器 列表 中 的 位 置 及 其 关系 ， 所 以 没有 对 定时 器 变量 全 部 元 素 进行 展开 。 接 下 来 的 
插入 过 程 其 实 跟 任务 插入 节拍 列表 的 过 程 是 差不多 的 ， 也 就 是 节点 插入 双向 列表 的 一 个 过 程 ， 读 者 可 以 结合 图 4-2 所 示 列 表 对 代码 清单 4-4 进 行 理解 。 
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图 4-2 ”定时 器 列表 





4.3 删除 定时 器 


当 定时 器 不 再 用 时 ， 可 调用 删除 函数 来 进行 删除 ， 所 谓 的 删除 不 是 真 的 将 软件 定时 器 的 从 单片机 的 内 存 中 删除 ， 而 且 清 空 定 时 器 的 变量 ， 
当 其 他 程序 段 企图 再 用 这 个 定时 器 的 时 候 ， 就 会 报错 ， 如 果 重 新 创建 ， 又 可 以 再 进行 使 用 。 


一 切 “ 瓜 葛 ”， 设 置 为 不 可 用 的 状态 ， 
其 参数 含义 如 下 。 
1) p_tmr: 指向 定时 器 变量 的 指针 。 


2) p_err: 指向 返回 错误 类 型 的 指针 ， 主 要 有 以 下 几 种 类 型 。 


OS_TMR 


pt 





















OS_TMR 


| lype 


ype 
Opt 


| Op | 





OS_TMR 


NextPtr 


其 他 元 素 




























清除 掉 


“ OS_ERR_NONE 


“OS_ERR_T 





没有 错 i 误 。 








日 or 
个 空 


tmr 没 有 指向 一 个 定时 器 变量 。 


间 针 。 





. OS_ERR_TMR_ISR 一 一 企图 再 中 断 中 删除 定时 器 。 


“ OS_ERR_TMR_INACTIVE 一 一 定时 器 


“ OS_ERR_TMR_INVALID_STATPB 一 一 定时 器 





还 没有 被 创建 或 者 已 经 被 删除 


器 的 状态 不 可 用 ， 可 能 出 错 了 。 


删除 定时 器 函数 OSTmrDel() 的 源码 如 代码 清单 4-5 所 示 。 


代码 清单 4-5 ”删除 定时 器 函数 OsTmrDel(0 
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#if OS CFG TMR DEL EN > Ou 
CPU BOOLEAN OSTmrDel (OS_TMR 
OS_ERR 
{ 
OS ERR err; 


#ifdef OS SE CRITICAL 
半 下 (P err 一 (OS ERR *)0) { 


*p_tmr, 
XD GLE) 


OS_SAFETY CRITICAL , EXCEPTION (); 





return (DEF | FALSE); 
} 
#engif 


// 中 断 中 不 允许 删除 定时 器 


#if OS CFG CALLED FROM ISR CHK EN > 0u 





if (OSIntNestingCtr > 
*p err = OS ERR TMR ISR; 
return (DEF FALSE); 
} 
#engdif 


// 参数 检测 
#if OS CFG ARG CHK EN > Ou 
if (p tmr == (OS TMR *)0) { 
*p err = 
return (DEF FALSE); 





} 
#endif 


// 内 核对 象 类 型 检测 
#if OS CFG OBJ TYPE CHK EN > 0u 
// 查看 是 不 是 定时 器 





(OS_NESTING CTR) 0) { 


OS ERR TMR INVALID; 


if (p tmr->Type != OS OBJ TYPE TMR) { 


*p err = OS ERR OBJ TYPE; 
return (DEF FALSE); 





} 
#endif 


// 进入 临界 段 
OSSchedLock (&err); 
#if OS CFG DBG EN > 0u 
// 将 定时 器 从 双向 链表 中 脱离 
OS_TmrDbgListRemove (P_tmr) 
#engdif 
OSTmrQty-——; 


// 根据 定时 器 的 状态 进行 操作 
switch (p tmr->State) { 
// 定时 器 处 于 运行 状态 

case OS TMR STATE RUNNING: 


// 将 定时 器 从 定时 器 列表 中 移 除 


OS a (p_tmr); 
// 清空 定时 器 
OS5_TmrClr (p tmr); 

// 退出 临界 段 
OssSchedUnlock (&err); 
*p_ err = OS ERR NONE; 
return (DEF ， TRIE) ， 


// 定时 器 之 前 已 经 被 删除 或 者 已 经 完成 ， 即 已 经 


case OS TMR _ STATE STOPPED: 

case OS TMR ， STATE ( COMPLETED: 
// 清空 定时 器 
OS5_TmrClr (p tmr); 
OsSSchedUnlock (&err) 
*p_ err = OS ERR NONE; 
return (DEF TRUE); 


// 定时 器 已 经 被 删除 
case OS TMR STATE UNUSED: 
OSSchedUnlock (&err) 
*p err = 











脱离 定时 器 列表 


OS ERR TMR INACTIVE; 


4 


2 
三 


4 


参 


9 return (DEF FALSE); 





76 

了 了 default: 

78 OSsSchegdUnlock (&err); 

了 8 *p err = OS ERR TMR INVALID STATE; 
80 return (DEF FALSE); 

81 } 

82 } 

83 #enqif 


删除 定时 器 函数 OSTmrDel() 首 先 检测 定时 器 的 状态 ， 如 果 定 时 器 处 于 运行 的 状态 ， 就 将 其 脱离 定时 器 列表 ， 然 后 调用 OS_TmrClr() 函 
器 的 元 素 。 如 果 是 已 经 停止 或 者 被 删除 ， 就 只 要 清空 定时 器 即 可 ， 在 停止 或 者 删除 的 时 候 ， 硬 件 脱 离 定 时 器 列表 。 其 他 的 都 返回 错误 。 


.4 ”脱离 定时 器 列表 


脱离 


代码 清单 4-6 ”脱离 定时 器 列表 OS TmrUnlink() 函 数 























定时 器 列表 函数 Os TmrUnlink() 的 源码 如 代码 清单 4-6 所 示 。 


$ OSCfg TmrWheelSize); 


1 void OS TmrUnlink (OS _ TMR *p tmr) 

2 { 

3 OS_TMR_ SPOKE *p_spoke; 

4 OS_TMR *p tmrl; 

3 OS_TMR *p tmr2; 

6 OS TMR SPOKE IX spoke; 

7 

8 

9 // 哈 项 算法 

1 spoke = (OS TMR SPOKE IX) (p tmr->Match % 
了 p_spoke = &OSCfg 1 TmrWheel [spoke]; 

12 

13 // 双向 链表 删除 节点 

14 if (p spoke->FirstPtr == p tmr) { 

二 过 p_tmrl = (OS TMR *)p tmr->NextPtr; 
16 p_spoke->FirstPtr = (OS TMR *)p tmrl; 

和 了 if (p tmrl != (OS TMR *)0) { 

18 p tmr1l->PrevPtr = = (OS TMR *)0; 

19 

20 } else { 

21 p_tmrl = (OS TMR *)p tmr->PrevPtr; 
22 p_tmr2 = (OS TMR *)p tmr->NextPtr; 
23 P_tmr1->NextPtr = p_ tmr2; 

24 if (Bp tmr2 != (O08 TMR *)0) { 

25 p tmr2->PrevPtr = = (OS TMR *)p tmrl; 
26 } 

27 } 

28 p tmr->State = OS TMR STATE STOPPED; 

29 p_tmr->NextPtr = (OS 了 *) OF 

30 RB tme->PrevPtr = (OS : Yb Uy 

31 p_spoke-— >NbrEntries--; 

32 } 


国 娄 


清 


空 定时 


oOs_TmrUnlink0 函 数 展示 的 定时 器 列表 脱离 定时 器 列表 的 过 程 跟 任务 脱离 节拍 列表 的 脱离 过 程 基本 是 上 一 模 一 样 的 ， 读 者 自行 对 照 节拍 列表 章 


内 容 和 图 4-2 所 示 流 程 进行 理解 。 


.5 ”停止 定时 器 


主要 用 来 停止 (不 是 暂停 ) 正在 运行 的 程序 ， 注 意 停 止 后 再 调用 OSTmrStart() 就 相当 于 是 重启 定时 器 ， 而 不 是 接着 停止 的 时 候 继续 定时 。 


数 
1) p_tmr: 定时 器 变量 指针 。 


2) opt: 停止 定时 器 时 候 的 设置 ， 主 要 有 以 下 的 几 个 选项 


: OS_OPT _TMR_CALLBACK 一 一 停止 的 时 候 调 用 回调 函数 ， 


` OS_OPT _TMR_CALLBACK_ARG 一 一 停止 的 时 候 调用 回调 函数 ， 回 调 函 数 


并 且 回 调 函 数 的 用 户 参 数 是 创建 定时 器 设置 的 。 


的 用 户 参数 是 根据 输入 参数 callback_arg 设 置 的 。 


-0OS_OPT_TMR_NONE 一 一 停止 的 时 候 不 执行 回调 函数 。 


3) callback _arg: 若 上 面 的 选项 设置 是 OS OPT TMR_CALLBACK ARG， 则 这 个 函数 将 作为 回调 函数 的 用 户 参 数 ， 即 使 创建 定时 器 的 时 候 设 置 
了 用 户 参 数 。 其 他 的 选项 ， 这 个 变量 可 以 随便 设置 。 


4) pP_err: 指向 返回 错误 类 型 的 指针 。 
. OS_ERR_TMR_INACTIVE 一 一 定时 器 已 经 被 删除 。 


“ OS_ERR_TMR_INVALID 





参数 p_tmrt 是 空 指针 。 


` OS_ERR_TMR_INVALID_STATE 一 一 定时 器 状态 不 可 用 。 





: OS_ERR_TMR_ISR 一 一 在 中 断 中 调用 了 这 个 函数 。 


. OS_ERR_TMR_ NO_CALLBACK 一 一 回调 函数 的 指针 p_fnct 是 空 指 针 。 





- OS_ERR_TMR_STOPPED 一 一 定时 器 已 经 停止 了 。 
定时 器 停止 函数 OsTmrStop() 的 源码 如 代码 清单 4-7 所 示 。 


代码 清单 4-7 ”定时 器 停止 函数 

















1 CPU BOOLEAN OSTmrStop (OS TMR *p tmr, 
2 OS_OPT opt, 

3 void *p callback arg, 
4 OS_ERR ho GEE) 
5 1 

6 OS TMR CALLBACK PTR p fnct; 

J OS_ERR err; 

8 

9 

0 

1 #ifdef OS SAFETY CRITICAL 

2 if (p err == (OS ERR *)0) { 

13 OS5_SAFETY CRITICAL EXCEPTION(); 
14 return (DEF FALSE); 

5 } 

6 #endif 

7 

8 // 不 能 再 中 断 中 停止 定时 器 

9 #if OS CFG CALLED FROM ISR CHK EN > 0u 
20 if (OSIntNestingCtr > (OS NESTING CTR) 0) { 
21 *p err = OS ERR TMR ISR; 

22 return (DEF FALSE) ， 

23 } 

24 #endif 

25 


26 // 参数 检测 
27 #if OS CFG ARG CHK EN > 0u 





28 if (p tmr = (OS TMR *)0) { 

29 *p err = OS ERR TMR INVALID; 
30 return (DEF FALSE); 

31 } 

32 #engdif 

33 


34 // 检测 内 核对 象 类 型 
35 #if OS CFG OBJ TYPE CHK EN > Ou 
36 // 如 果 内 核对 象 类 型 不 是 定时 器 














37 if (P_tmr->Type != OS OBJ TYPE TMR) { 

38 *p err = OS ERR OBJ TYPE; 

39 return (DEF FALSE); 

40 } 

41 #endif 

42 

43 OSSchedLock (&err); 

44 // 根据 定时 器 的 状态 

45 switch (p tmr->State) { 

46 // 定时 器 正在 运行 

47 case OS TMR STATE RUNNING: 

48 // 将 定时 器 脱离 定时 器 列表 

49 OS_ TmrUnlink(p tmr); 

50 *p err = OS ERR NONE; 

51 // 根据 选项 执行 回调 函数 

52 switch (opt) { 

53 case OS OPT TMR CALLBACK: 

54 p tinct = p tmr->CallbackPtr; 

55 证 (p fnct != (OS TMR CALLBACK PTR) 0) { 
56 // 使 用 创建 时 候 的 参数 

和 (*p_fnct) ((voiqd *)p tmr, p_ tmr->CallbackPtrArg); 
58 } else { 

59 *p err = OS ERR TMR NO CALLBACK; 
60 } 


61 break; 


62 


























63 Case OS OPT TMR CALLBACK ARG : 

64 p fnct = p tmr->CallbackPtr; 

&5 江夏 (P_fnct != (OS TMR CALLBACK PTR)O0) { 
66 /7 使 用 调用 参数 p_callback arg 作 为 回调 函数 的 参数 
67 (*p_fnct) ((voiqd *)p tmr, p callback arg); 
68 } else { 

69 *p err = OS ERR TMR NO CALLBACK; 

70 } 

El break; 

72 

73 case OS OPT TMR NONE: 

74 break; 

35 

76 default: 

77 OSSchedUnlock (&err); 

78 *p err = OS ERR OPT INVALID; 

79 return (DEF FALSE); 

80 } 

81 OSSchegqUnlock (&err); 

82 return (DEF TRUE); 

83 

84 // 定时 器 已 经 完成 (一 次 性 定时 器 ) 或 者 停止 ， 返 回 错误 提示 信息 
85 case OS TMR STATE COMPLETED: 

86 Case OS_TMR STATE STOPPED: 

87 OSSchegqUnlock (&err); 

88 *p err = OS ERR TMR STOPPED; 

89 return (DEF TRUE); 

90 

91 // 定时 器 已 经 被 删除 ， 返 回 错误 提示 信息 

92 case OS TMR STATE UNUSED: 

93 OSSchegdUnlock (&err); 

94 *p err = OS ERR TMR INACTIVE; 

95 return (DEF FALSE); 

96 

97 default: 

98 OsSSchedUnlock (&err); 

99 *p err = OS ERR TMR INVALID STATE; 

100 return (DEF FALSE); 

101 } 加 

102 } 





只 有 运行 状态 的 定时 器 才 可 以 停止 ， 函 数 OSTmrstop( 首 先 判断 状态 是 运行 状态 后 ， 将 定时 器 脱离 定时 器 列表 ， 然 后 根据 选项 决定 是 否 要 调用 回 
函数 ， 以 及 调用 回调 函数 时 的 参数 选择 等 。 


4.6 定时 器 内 部 运行 机 制 


前 面 的 函数 讲 到 这 里 ， 想 必 大 家 对 定时 器 的 机 制 还 不 是 真正 的 理解 ， 只 知道 创建 、 删 除 、 停 止 等 过 程 是 怎么 实现 的 ， 这 些 都 只 是 表面 的 东西 ， 接 
下 来 我 们 来 看 看 可 以 有 无 数 个 定时 器 的 奥秘 。 


4.7 ”定时 器 剩余 定时 时 间 获 取 


调用 OSTmrRemainGet0 这 个 函数 来 获取 定时 器 剩余 的 定时 时 间 也 是 很 简单 的 ， 只 需要 输入 参数 定时 器 变量 指针 和 指向 存放 错误 类 型 的 指针 ， 接 
着 在 没有 错误 的 情况 下 就 会 返回 一 个 大 于 0 的 数值 如 代码 清单 4-11 所 示 。 注 意 在 例 程 中 这 个 数值 的 单位 是 10ms。 如 果 定 时 器 是 处 于 停止 的 状态 ， 那 么 
返回 的 剩 下 的 定时 时 间 就 是 定时 器 重新 开始 后 第 一 次 定时 的 时 间 ， 至 于 定时 器 第 一 次 定时 的 时 间 是 多 长 要 根据 不 同 定时 器 不 同 设置 而 定 ， 前 面 已 经 介 


绍 过 。 





代码 清单 4-11 ”定时 器 剩余 定时 时 间 获 取 函 数 





OS TICK OSTmrRemainGet (OS_TMR *p tmr, 
OS ERR *p err) 
{ 
OS TICK remain; 
OS_ERR err; 


#ifdef OS SAFETY CRITICAL 
if (P err =— (OS ERR *)0) { 
OS_ SAFETY CRITICAL , EXCEPTION (); 
return ((OS TICK)0); 





J 
如 
3 
4 
3 
6 
7 
8 
9 
10 
411 
12 


13 } 
14 #endif 


了 
78 


#if OS CFG CALLED FROM ISR CHK EN > Ou 
if (OSIntNestingCtr > (OS NESTING CTR)0) { 
*p err = OS ERR TMR ISR; 四 
return ((OS TICK)0); 








} 
#endif 


#if OS CFG ARG CHK EN > 0u 
if (p tmr = (OS TMR *)0) { 
*p err = OS ERR TMR INVALID; 
return ((OS TICK)0); 





} 
#endif 


#if OS CFG OBJ TYPE CHK EN > 0u 
if (p tmr->Type != OS OBJ TYPE TMR) { 
*p err = OS ERR OBJ TYPE; 
return ((OS TICK)0); 








} 
#endif 


OSSchedLock (&err); 

// 判断 定时 器 状态 

Switch (p tmr->State) { 

case OS TMR STATE RUNNING: 
remain = Pp tmr—>Matoh 

— OSTmrTickCtr; 

P_tmr->Remain = remain; 
OSSchegdUnlock (&err); 
pp. Brr = OS_ ERR NONE; 
return (remain); 


case OS TMR STATE STOPPED: 
if (p tmr->Opt== OS OPT TMR PERIODIC) { 
if (p tmr->Dly == 0u) { 
remain = p_ tmr->Period; 
} else { 
remain = p_ tmr->Dly; 


} else { 

remain = p tmr->Dly; 
} 
P_tmr->Remain = remain; 
OSSchegqUnlock (&err); 
SKE = OS_ ERR NONE; 
return (remain); 本 


case OS TMR STATE COMPLETED: 
OSSchedUnlock (&err); 
*p_err = OS ERR NONE; 
return ((OS TICK)0); 


case OS TMR STATE UNUSED: 
OsSSchedUnlock (&err); 
*p err = OS ERR TMR INACTIVE; 


return ((OS TICK)0); 








default: 
OSSchegdUnlock (&err); 
*p err = OS ERR TMR INVALID STATE; 
return ((OS TICK)0); 





} 





位 都 是 定时 器 定时 的 单位 


函数 OSTmrRemainGet( 先 判断 定时 器 的 状态 。 如 果 是 正在 运行 的 定时 器 ， 就 用 到 时 的 时 间 减 去 现在 的 定时 器 的 计数 OSTmrTickCtr， 两 者 的 单 





10ms， 得 到 剩 下 定时 时 间 后 作为 返回 值 返回 。 


4.8 定时 器 状态 获取 


获取 定时 器 状态 的 函数 OSTmrstateGet() 同 样 是 输入 定时 器 变量 指针 和 指向 存放 错误 类 型 的 指针 就 可 以 返回 定时 器 的 状态 ， 如 代码 清单 4-12 所 


代码 清单 4-12 ”定时 器 状态 获取 函数 


BL 
2 
3 
4 
5 
6 
7 
8 
9 
0 


1 





OS_STATE OSTmrStateGet (OS IMR *p tmr, 
OS ERR *p err) 
{ 
OS STATE state; 
CPU SR ALLOC(); 


#ifdef OS SAFETY CRITICAL 
if (p err == (OS ERR *)0) { 
OS SAFETY CRITICAL EXCEPTION (); 


return (O05 TMR STATE UNUSED); 





二 } 


























12 #enqif 

13 

14 #if OS CFG CALLED FROM ISR CHK EN > 0u 
二 导 if (OSIntNestingCtr > (OS NESTING CTR) 0) { 
16 *p err = OS ERR TMR ISR; 

bE return (OS TMR STATE UNUSED); 
18 } 

19 #enqif 

20 

21 #if OS CFG ARG CHK EN > 0u 

22 EE (P tmr = (OS ， TMR *)0) { 

23 xp err = OS ERR TMR INVALID; 
24 return (OS TMR STATE UNUSED); 
25 } 

26 #endif 

27 

28 #if OS CFG OBJ TYPE CHK EN > Ou 

29 if (p tmr- >Type != OS_OBJ TYPE TMR) { 
30 *p err = OS ERR OBJ TYPE; 

过 return (OS TMR STATE UNUSED); 
32 

33 #enqif 

34 

35 CPU_CRITICAL ENTER () ; 

36 State = p tmr->State; 

7 switch (state) { 

38 case OS TMR STATE UNUSED: 

39 case OS_TMR STATE ， STOPPED: 

40 case OS_TMR ， STATE COMPLETED: 

41 case OS TMR STATE ”RUNNING: 

42 *P err = ODS ] ERR ~ NONE; 

43 break; 

44 

45 default: 

46 *p err = OS ERR TMR INVALID STATE; 
47 break; 

48 } 

49 CPU_ CRITICAL EXIT (); 

50 return (state); 

Sl、 


函数 OSTmrStateGet() 将 定时 器 状态 元 素 作为 返回 值 返回 ， 只 是 在 前 后 加 了 一 些 参 数 检测 和 | 临界 段 保护 。 


4.9 总结 


从 一 开始 对 定时 器 相关 函数 的 使 用 和 解析 到 后 面 对 定 时 器 机 制 的 解析 ， 想 必 大 家 对 定时 器 整个 运作 有 了 更 深 的 了 解 。 定 时 器 的 创建 、 删 除 、 停 止 
这 些 操作 无 非 就 是 操作 定时 器 列表 的 双向 列表 和 根据 不 同 的 设置 进行 定时 器 状态 的 转化 以 及 相关 的 处 理 。 至 于 检测 定时 器 到 期 ， 系 统 将 时 间 节 拍 进行 
分 频 得 到 定时 器 任务 执行 的 频率 ， 在 定时 器 任务 中 ， 系 统 采 用 哈 希 算法 进行 检测 有 没有 定时 器 到 期 ， 然 后 进行 执行 回调 函数 等 操作 。 软 件 定时 器 最 最 
核心 的 一 点 是 在 底层 的 一 个 硬件 定时 器 上 进行 软件 分 频 ，HC/OS- 川 对 应 的 硬件 定时 器 就 是 产生 时 钟 节拍 的 那个 定时 器 。 


第 5 草 ”多 值 信号 量 





本 章 介 绍 的 都 是 多 值 信号 量 ， 没 有 特殊 说 明 ， 讲 述 的 信号 量 都 是 多 值 信号 量 。 本 章 涉及 的 信号 量 操作 很 多 ， 因 此 也 是 相对 复杂 的 一 章 ， 不 过 读 完 
了 本 章 ， 后 面 的 消息 队列 、 事 件 标志 、 互 斥 信号 量 等 部 分 都 是 一 样 的 了 。 在 阅读 本 章 之 前 请 读者 先 思 考 这 样 的 问题 ， 在 我 们 的 理解 中 任务 应 该 是 互 不 
相干 的 。hC/OS- 川 是 如 何 做 到 在 一 项 任务 发 布 信号 量 的 时 候 ， 另 一 项 等 待 该 信号 量 的 任务 就 可 以 “ 收 到 ”， 并 且 优 先 级 足够 高 时 还 会 就 绪 ? 


5.1 实例 演示 


本 章 的 实例 一 共有 两 个 ， 一 个 是 信号 量 用 于 标志 事件 的 发 生 ， 另 一 个 是 信号 量 用 于 保护 资源 。 


实例 5-1 中 ，LED 灯 等 待 信号 量 的 发 布 ， 处 于 等 待 状态 ， 按 下 按键 后 ， 发 布 信号 量 ，LED 灯 得 到 信号 ， 开 始 正常 运行 ， 即 开始 闪烁 。 这 样 ， 信 和 号 


的 发 布 就 相当 于 按键 被 按 下 这 个 事件 的 发 生 ，LED 灯 和 按键 是 两 项 任务 ， 通 过 信号 量 进行 “沟通 ”。 经 过 测量 ， 从 信号 量 发 布 ， 即 按键 按 下 后 ， 到 
LED 灯 解除 等 待 状 态 这 个 过 程 的 时 间 差 为 26Nhs ( 见 图 5-1) 。 这 个 过 程 还 可 以 看 成 是 按键 按 下 事件 与 LED 灯 开始 闪烁 同步 ， 所 以 信号 量 有 时 也 用 来 同 
步 事 件 。 





实例 5-2 是 采用 信号 量 模拟 停车 场 的 一 个 资源 管理 实例 ， 具 体操 作 如 图 5-2 所 示 串 口 的 提示 。 注 意 ， 如 果 车 子 没 有 申请 到 车 位 就 “ 开 走 ” ， 不 再 等 
待 ， 这 就 导致 倒数 第 三 行 在 恢复 一 个 车 位 后 ， 倒 数 第 四 行 那 辆 车 由 于 没有 得 到 车 位 而 开 走 了 。 当 然 ， 也 可 以 稍微 修改 一 下 程序 ， 让 车 子 在 申请 不 到 车 
位 时 一 直 等 待 。 


读者 可 能 会 想 ， 这 个 我 不 用 操作 系统 也 可 以 实现 ， 就 是 释放 停车 位 的 时 候 将 一 个 变量 加 1， 表 示 多 了 一 个 停车 位 ， 占 用 停车 位 的 时 候 将 这 个 变量 
的 值 减 1 就 可 以 。 是 的 ， 这 就 是 信号 量 最 本 质 的 操作 ， 只 不 过 系统 为 信号 量 加 入 了 另外 一 些 功能 和 选项 。 














《野火 会 功能 调试 助手 V0.2.0 
齐 口 调试 功能 | GSM 调 试 功能 | GPs 定 位 功能 | 





COM3 ps 。 
端口 发 亢 1 时 间 扒 是 238325453 
115200 解 B 状 ; 司 蕉 是 238327363 
- 卖 收 到 信号 量 与 发 布 信号 量 的 时 间 相 差 26us 


None 


8 


1 


停止 显示 


育 动 安 送 周期 ”1000 毫秒 
[| 自动 发 送 。 “| 十 六 进 制 发 送 





手动 发 送 


| 清寺 | 


实 御 路 全 还 滩 选 择 要 发 送 的 文件 


圳 口 已 开启 接收 字 节 数 2689 ”发 送 字 节 数 : 








图 5-1 信号 量 发 布 时 间 和 接收 信号 量 之 间 的 时 间 差 测量 示意 图 


.野火 多 功能 滑 试 助手 V020 中 
率 口 请 二 苏 能 | GSM 调 坛 功 能 | GPS 定位 功能 交流 学 习 














st 这 是 一 个 用 信号 量 模拟 停车 场 车 位 管理 的 例 程 


115200 JJ 一、 pam he pe 
如 果 有 车 子 进 来 需要 停车 位 ， 请 按 下 Keyl ， 系 统 会 提示 现在 是 否 有 停车 位 


None 


如 果 权 释放 停车 位 ， 请 按 下 Key2 


现在 剩 下 的 停车 位 有 3 个 





文件 路 径 ) 还 没 选 择 要 发 送 的 文件 








图 5-2 ”信号 量 模拟 停车 场 


定义 完 信号 量变 量 后 就 可 以 调用 OSsemCreate( 进 行 “ 创 建 ”， 跟 定时 器 的 “创建 ”差不多 ， 由 前 面 介绍 的 定时 器 的 创建 函数 ， 我 们 明白 其 实 这 
里 的 “创建 ” 指 的 就 是 对 内 核对 象 的 一 些 初始 化 。 要 特别 注意 的 是 内 核对 象 使 用 之 前 一 定 要 先 创建 ， 必 须要 保证 这 个 创建 过 程 在 所 有 可 能 使 用 内 核对 
象 之 前 完成 。 比 如 ， 开 始 创建 多 个 任务 的 时 候 ， 这 多 个 任务 都 有 使 用 到 某 一 内 核对 象 ， 那 么 就 应 该 在 他 们 之 间 优 先 级 最 高 的 任务 中 创建 这 个 内 核对 
象 。 笔 者 曾经 就 犯 了 这 个 错误 ， 在 优先 级 不 是 最 高 的 任务 中 创建 内 核对 象 ， 结 果 导 致 程序 部 分 功能 处 于 瘫痪 状态 。 原 因 是 因为 优先 级 最 高 最 先 占 用 了 
CPU， 运 行内 核对 象 相关 操作 的 AP1， 创 建 内 核对 象 的 代码 在 低 优先 级 中 不 能 先 得 到 执行 ， 内 核对 象 的 初始 化 等 必要 操作 没有 先 执 行 到 。 








1) p_sem: 指向 信号 量变 量 的 指针 。 




















2) p_name: 指向 信号 量变 量 名 字 字 符 串 的 指针 。 


3) cnt: 信号 量 的 初始 值 ， 用 做 资源 保护 的 信号 量 时 ， 这 个 值 通常 跟 资源 的 数量 相同 ， 用 做 标志 事件 发 生 的 信号 量 时 ， 这 个 值 设置 为 0， 标 志 事 
情 还 没有 发 生 。 




















4) p_err: 指向 返回 错误 类 型 的 指针 。 


其 错误 类 型 如 下 。 


* OS_ERR_CREATE_ISR 一 一 在 中 断 中 创建 信号 量 是 不 被 允许 的 ， 返 回 错误 信息 。 
* OS_ERR_ILLEGAL_CREATE_RUN_TIME 一 一 在 定义 DSSafetyCtiticalStartFlag 为 DEF_TRUE 后 就 不 运行 创建 任何 内 核对 象 。 


“ OS_ERR_NAME 





参数 p_name 是 个 空 指针 。 


* OS_ERR_OBJ_CREATED 一 一 信号 量 已 经 被 创建 ， 不 过 函数 中 并 没有 涉及 到 这 个 错误 的 代码 。 





* OS_ERR_OBJ_PTR_NULL 参数 p_sem 是 个 空 指针 。 


. OS_ERR_OBJ_TYPE 





参数 p_sem 被 初始 化 为 别 的 内 核对 象 了 。 





* OSSemCreate() 函数 的 具体 代码 如 代码 清单 5-1 所 示 。 


代码 清单 5-1 ”信号 量 创建 函数 





voiqd OSSemCreate (OS SEM *p_sem, 
CPU_CHAR *p_name, 
OS SEM CTR cnt, 
OS_ERR *]s EE) 


CPU_SR_ALLOC (); 


#ifdef OS SAFETY CRITICAL 





if (p err 一 (OS ERR *)0) { 
OS5_SAFETY CRITICAL EXCEPTION(); 
return; 
} 
#engdif 


#ifdef OS SAFETY CRITICAL IEC61508 
if (OSSafetyCriticalStartFlag == DEF TRUE) { 
*p err = OS ERR ILLEGAL CREATE RUN TIME; 
return; 








宝生 生生 和 和 
OO0OOmO~OUPONPOULWOAOOOPODP 


DD 
SS 


} 
#endif 


D 
CD 


#if OS CFG CALLED FROM ISR CHK EN > Ou 
if (OSIntNestingCtr > (OS NESTING CTR) 0) { 





DD 
Cn 心 








26 *p err = OS ERR _ CREATE ISR; 
27 return; 

28 } 

29 #engdif 

30 

31 #if OS CFG ARG CHK EN > 0u 

32 if (p sem == (OS SEM *)0) { 

33 *p err = OS ERR OBJ PTR NULL; 
34 return; 

35 } 

36 #endif 

37 

38 CPU _ CRITICAL ENTER(); 

39 // 初始 化 信号 量变 量 所 有 元 素 

40 p_sem->Type = OS OBJ TYPE SEM; 
41 p_sem->Ctr = cnt; 

42 P_sem->TS = (CPU TS)0; 

43 p_sem->NamePtr = p name; 

44 // 初始 化 信号 量 的 等 待 列表 

45 OS_PengdListInit (&p_ sem->PengList); 
46 

47 #if OS CFG DBG EN > 0u 

48 OS_SemDbgListAdd (p sem); 

49 #endif 

50 OSSemOty++; 

51 

52 CPU_ CRITICAL EXIT (); 

53 *p err = OS ERR NONE; 

54 } 





函数 OSsemCreate( 将 信号 量变 量 的 元 素 进行 初始 化 ， 代 码 清单 5-1 的 第 43 行 ，OS_PendListlnit( 函 数 对 该 信号 量 的 挂 起 队列 进行 初始 化 ， 等 待 
列表 用 来 管理 等 待 信号 量 的 任务 。 


5.3 ”信号 量 等 待 队列 


作者 将 多 个 信号 量 和 他 们 的 等 待 队列 做 成 了 图 5-3 所 示 的 结构 ， 主 要 突出 他 们 之 间 的 关系 。 可 能 很 多 读者 感觉 都 不 好 了 ， 唱 着 “没有 一 点 点 防 


备 ， 没 有 一 丝 丝 顾虑 ， 你 就 这 样 出 现在 我 眼前 .……” 。 但 是 这 么 复杂 的 数据 结构 却 带 来 了 操作 时 索引 的 方便 ， 后 面 讲解 程序 的 时 候 读 者 将 会 深刻 体会 
到 。 其 实 这 也 不 是 很 复杂 ， 下 面 简单 介绍 他 们 的 一 些 关 系 。 这 些 跟 节拍 列表 和 定时 器 列表 都 有 很 多 相似 的 地 方 ， 学 习 的 时 候 多 融会 贯通 ， 这 在 后 面 的 
其 他 的 内 核对 象 中 也 是 有 很 大 部 分 是 一 样 的 。 下 面 讲解 的 文字 前 面 的 序号 代表 图 5-3 所 示 对 应 标号 的 地 方 。 


5-3 所 示 标 号 合 义 如 下 。 


@ 表 示 每 个 信号 量 都 有 一 个 等 待 队列 ， 等 待 队列 由 OS_PEND_LIST 这 个 类 型 的 变量 管理 ， 可 能 有 多 个 任务 在 等 待 同 一 个 内 核对 象 ， 那 么 这 些 任 务 
就 是 用 这 个 结构 体 来 管理 的 。NbrEntries 表 示 等 待 队 列 有 多 少 个 任务 。 





@ 表 示 TailPtr 指 向 等 待 队列 最 后 一 个 任务 ，HeadList 指 向 等 待 队列 开始 的 任务 。 等 待 队列 是 按照 优先 级 来 排序 的 ， 所 以 TailPtr 指 向 的 任务 是 最 低 
的 ，HeadList 指 向 的 任务 是 最 高 的 。 这 样子 的 排序 是 因为 当 提交 信号 量 的 时 候 会 让 优先 级 最 高 的 任务 先 就 绪 。 


@@ 表 示 等 待 队 列 上 面 有 多 少 个 任务 ， 就 有 多 少 个 OS_PEND_DATA 类 型 的 变量 ， 每 个 等 待 的 任务 都 独自 占有 一 个 。 任 务 不 是 直接 链接 到 等 待 队列 
中 ， 而 是 通过 叫做 OS_PEND_DATA 的 数据 结构 作为 媒介 来 链接 的 。 





@ 表 示 PrevPtr 和 NextPtr 构 成 双向 指针 ， 将 各 个 OS_PEND_DATA 类 型 的 变量 串 起 来 ， 双 向 链表 的 好 处 就 是 删除 和 插入 操作 变 得 简单 了 。 





@ 表 示 TCBPtr 指 向 OS_PEND_DATA 类 型 的 变量 对 应 的 任务 控制 块 TCB。 





@ 表 示 PendObjPtr 指 向 等 待 的 内 核对 象 ， 因 为 像 队列 、 事 件 标志 等 的 等 待 队 列 中 也 是 有 OS_PEND_DATA 变 量 ， 这 个 元 素 可 以 区 分 任务 等 待 的 是 
哪个 内 核对 象 。 











@、@@ 表 示 把 所 有 信号 量 加 入 到 双向 链表 ， 方 便 用 户 查看 所 有 的 信和 号 量 数据 ， 注 意 这 里 的 插入 的 顺序 是 建立 的 顺序 ， 而 且 跟 串 起 
OS_PEND_DATA 的 双向 链表 不 一 样 ， 串 起 O9_ PEND_DATA 的 双向 链表 主要 是 串 起 OS9_PEND_DATA 类 型 变量 ， 而 这 里 双向 链表 串 起 的 是 信号 量 。 后 
面 将 展示 以 信号 量 为 例 插 入 的 过 程 ， 其 他 的 内 核对 象 比如 定时 器 ， 定 时 器 的 OS TmrDbgListAdd 在 前 面 讲 定时 器 的 时 候 没有 讲 ， 但 是 它 跟 信号 量 的 都 
是 很 相似 的 。 其 格式 一 般 是 OS_XXXDbgListAdd 和 OS_XXXDbgListRemove， 接 下 来 以 信号 量 为 例 ， 后 面 其 他 内 核对 象 不 会 再 讲解 。 
OS_XXXDbgListAdd 是 在 内 核对 象 XXX 创 建 的 时 候 添加 到 调试 的 双向 链表 中 去 的 ，OS_XXXDbgListRemove 是 在 内 核对 象 XXX 被 删除 的 时 候 从 调试 的 
双向 链表 中 删除 。 如 果 OS_CFG_DBG _EN 置 1， 信 号 量 才 会 被 全 部 串 起 来 。OSSsemDbgListPtr 是 一 个 全 局 变量 ， 它 指向 最 后 一 个 被 串 上 的 信号 量 ， 其 
他 的 内 核对 象 也 有 类 似 的 变量 OSXXXDbgListPtr， 都 是 指向 最 后 一 个 被 串 上 的 内 核对 象 变量 。 











@ 表 示 信 和 号 量 的 元 素 DbgNamePtr 保 存 的 是 等 待 列表 中 优先 级 最 高 的 任务 的 名 字 ， 只 是 为 了 方便 调试 。 
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图 5-3 ”信号 量 及 其 等 待 队 列 


5.4 “内 核对 象 添加 到 调试 双向 链表 


下 面 以 信号 量 添 加 到 调试 的 双向 链表 为 例 ， 详 细 讲解 节点 插入 到 双向 链表 中 的 过 程 ， 具 体 代 码 如 代码 清单 5-2 所 示 。 


代码 清单 5-2 信号 量 添加 到 双向 链表 中 


1 #if OS CFG DBG EN > 0u 
2 void OS SemDbgListAdd (OS SEM *p sem) 
3 { 


4 p_sem->DbgNamePtr = (CPU CHAR *) ((void *)"™ "); 
二 P_sem->DbgPreVPtL = (OS_SEM a 

6 if (OSSemDbgListPtr == (OS SEM *)0) { 

本 P_sem->DpgNextPtL = (OS_ SEM 7 

8 } else { 

9 Pp_sem->DbgNextPtr = OSSemDbgListptr; 

10Q OSSemDbgListPtr->DbgPrevPtr = p sem; 

二 } 

12 OSSemDbgListPtr = p_sem; 

13 jj 








代码 清单 5-2 的 第 6 行 首先 检测 是 不 是 第 一 个 插入 ， 如 果 是 直接 将 指向 前 后 的 指针 分 别 指向 90， 因为 只 有 一 个 信号 量 在 双向 链表 中 ， 然 后 将 
OSSemDbgListPtr 指 向 这 个 第 一 个 插入 的 信号 量 ， 流 程 如 图 5-4 所 示 。 图 5-4 所 示 标 号 的 含义 如 下 。 





操作 前 ”OSSemDbgListPtr 一 一 0 


操作 顺序 OSSemDbgListPtr 
,3 
OS SEM 

0 


信号 量 其 他 
元 又 


图 5-4 信号 量 插入 调试 列表 的 示意 图 1 





@ 表 示 代码 清单 5-2 的 第 5 行将 插入 的 信号 量 的 下 一 个 指向 0。 
@ 表 示 代 码 清单 5-2 的 第 7 行将 前 一 个 也 指向 0。 


@ 表 示 代 码 清单 5-2 的 第 12 行 调整 OSSemDbgListPtr 指 向 最 后 一 个 。 





如 果 不 是 第 一 个 插入 的 ， 由 于 这 个 双向 链表 是 根据 信号 量 创建 的 时 间 前 后 插入 的 ， 所 以 这 个 时 候 肯 定 是 插 到 最 后 ， 如 图 5-5 所 示 。 
图 5-5 所 示 标 号 的 含义 如 下 。 


@ 表 示 代码 清单 5-2 的 第 5 行 首先 将 插入 的 信号 量 的 下 一 个 指向 0。 


@ 表 示 代 码 清单 5-2 的 第 9 行 插入 的 指向 前 一 个 ， 即 是 未 更 新 前 的 OSSemDbgListPtr 指 向 的 信号 量 。 
@ 表 示 代 码 清单 5-2 的 第 10 行 原来 最 后 一 个 的 下 一 个 指向 当前 插入 的 信号 量 。 


@ 表 示 代 码 清单 5-2 的 第 12 行 调整 OSSemDbgListPtr 指 向 最 后 一 个 。 


操作 顺序 只 要 保证 、@ 在 @ 前 面 即 可 ， 因 为 @、@ 的 操作 需要 前 一 个 信号 量 的 参与 ， 而 OSSemDbgListPtr 正 是 指向 前 一 个 信号 量 。 如 果 @ 在 
前 面 , 更 新 了 OSSemDbgListPtr， 那 么 前 一 个 信号 量 就 不 能 被 找到 了 。 这 些 都 是 在 操作 双向 链表 当中 要 注意 的 ， 不 用 去 死记 ， 就 是 要 保证 操作 的 便 


捷 的 同时 不 能 影响 全 局 ， 如 果 有 影响 ， 就 进行 顺序 的 调整 。 
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图 5-5 ”信号 量 插入 调试 列表 的 示意 图 2 


5.5 ”内 核对 象 欠 调试 双向 链表 中 删除 


—»>0 


OSs _semDbgListRemove() 函 数 的 功能 是 从 调试 双向 链表 中 移 除 某 一 个 信号 量 ， 这 个 操作 在 删除 信号 量 的 时 候 执 行 。 根 据 移 除 的 信号 量 在 双向 链 


表 中 的 位 置 进行 不 同 的 移 除 操作 。 下 面 以 信号 量 从 调试 的 双向 链表 中 移 除 为 例 ， 详 细 讲解 节点 从 双向 链表 中 移 除 的 过 程 ， 如 代码 清单 5-3 所 示 。 


代码 清单 5-3 ”信号 量 从 调试 双向 链表 中 删除 








1 void OS SemDbgListRemove (OS SEM *p sem) 

2 1 

3 OS SEM *p sem next; 

4 OS SEM *p sem prev; 

a 

6 

7 P_sem prev = p sem->DbgPrevPptr; 

8 P_sem next = p sem->DbgNextPtr; 

9 

10 if (p sem prev == (OS SEM *)0) { 

3 OSSemDbgListPtr = p_ sem next; 

12 if (p sem next != (OS ; SEM *)0) { 

13 p_ sem next->DbgPrevPtr = (OS SEM *)0; 
14 } 

| p_sem->DbgNextPtr = (OS SEM *)0; 

16 

17 } else if (p sem next == (OS SEM *)0) { 
18 P_sem prev->DbgNextPtr = (OS SEM *)0; 
19 Pp_sem->DbgPrevPtr = (OS _ SEM *)0 
20 

21 } else { 

22 p_sem prev->DbgNextPtr = p sem next; 
23 Pp_sem next->DbgPrevPtr = p sem prev 
24 p_sem->DbgNextPtr = (OS SEM *)0 
ds Pp_sem->DbgPrevPtr = (OS SEM *)0; 
26 } 

27} 








代码 清单 5-3 的 10~ 16 行 : 如 果 移 除 的 信号 量 在 双向 链表 的 最 后 。 其 流程 如 图 5-6 所 示 。 图 5-6 所 示 标号 的 含义 如 下 。 


@@ 表 示 代码 清单 5-3 的 11 行 将 OSSemDbgListPtr 在 列表 中 调整 到 倒数 第 二 个 。 
@ 表 示 代码 清单 5-3 的 13 行 将 倒数 第 二 个 的 DbgPrevPtr 指 向 0， 因 为 这 个 时 候 在 删除 完 最 后 一 个 倒数 第 二 个 就 是 最 后 一 个 了 。 


@ 表 示 代 码 清单 5-3 的 15 行 将 要 删除 的 信号 的 DbgNextPtr 指 向 0。 
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图 5-6 ”信号 量 从 双向 链表 中 移 除 示意 图 1 





代码 清单 5-3 的 17~20 行 : 如 果 移 除 信号 量 在 双向 链表 的 最 前 面 。 其 流程 如 图 5-7 所 示 。 
图 5-7 所 示 标 号 的 含义 如 下 。 
@ 表 示 代码 清单 5-3 的 18 行 将 第 二 个 信号 量 的 DbgNextPtr 指 向 0。 


@ 表 示 代 码 清单 5-3 的 19 行 将 第 一 个 信号 量 的 DbgPrevPtr 指 向 0， 这 样 ， 第 一 个 信号 量 就 跟 整 个 链表 分 开 了 。 
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并 令 OSSemDbgListPtr 指 向 它 
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图 5-7 信号 量 从 双向 链表 中 移 除 示意 图 2 





代码 清单 5-3 的 22~25 行 : 如 果 移 除 的 信号 量 在 中 间 。 其 流程 如 图 5-8 所 示 。 图 5-8 所 示 标 号 的 含义 如 下 。 


@、@ 表 示 代码 清单 5-3 的 22、23 行 将 要 删除 的 信号 量 “ 隔 空 ” 绕 开 了 。 


操作 前 0 


操作 顺序 0 








OS_SEM 





@@、@ 表 示 代 码 清单 5-3 的 24、25 行 将 要 删除 信号 量 指向 前 后 的 指针 调整 。 


OS_SEM 


OS_SEM 











DbgNextPtr 













DbgNextPtr 


DbgNextPtr 





















































































OSSemDbgListPtr 


































DbgPrevPtr DbgPrevPtr 0 
信号 量 其 他 言 号 量 其 他 诗 写 量 其 他 
元 素 元 素 元 素 
OSSemDbgListPtr 
OS_SEM OS_SEM OS_ SEM 
DbgNextPtr (OO DbgNextPtr “一 DbgNextPtr 
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5.6 ”部 分 内 核对 象 数据 结构 的 特点 
接着 来 看 信号 量 ， 互 斥 信号 量 ， 
体 的 把 握 。 
信号 量 
OS_SEM 
OS PEND LIST 
S_ PEND OBJ 

















图 5-8 ”信号 量 从 双向 链表 中 移 除 示意 图 3 















事件 标志 ， 消 息 队列 数据 结构 的 特点 ， 如 图 5-9 所 示 。 这 部 分 内 容 先 放 在 这 里 是 想 让 读者 对 这 些 内 核对 象 有 个 整 





















































互 斥 信号 量 事件 标志 消息 队列 
OS MUTEX OS FLAG GRP OS Q 
Iype | pe Type 
NamePtr | | NamePtr NamePtr 
. 1 s 
| TailPtr | | TailPtr | a | TailPtr | ]Ptr 
NbrEntries LailPtr INbrEntries TailPtr NbrEntries| ~ — 
HeadPtr h HeadPtr | 
DbgPrevPtr | | DbgPrevPtr 
DbegNextPtr | ' DbgNextPtr 
DbgNamePtr | | DbgNamePtr 
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内 核对 象 数据 类 型 对 比 图 





图 5-9 
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NbrEntriesMax 
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OutPtr 











注意 : 图 中 用 实 线圈 起 来 的 OS_PEND_LIST 表 示 内 核对 象 的 结构 体 真 的 有 这 个 结构 体 。 而 用 虚线 圈 起 来 的 OS_PEND_OBJ 表 示 这 个 结构 体 跟 内 核 
对 象 的 结构 体 这 部 分 是 相同 的 。 具 体 看 内 核对 象 类 型 定义 就 知道 。 


1) 这 几 个 内 核对 象 的 数据 结构 还 是 有 很 大 部 分 是 相同 的 。 他 们 的 操作 有 一 些 也 是 有 很 大 的 相似 性 ， 这 些 操作 就 在 文件 os_core.c 中 。 举 个 例 
子 ，OSQPend 和 OSsemPend 由 于 一 个 是 队列 ， 一 个 是 信号 量 ， 所 以 开始 处 理 这 两 个 函数 时 是 有 点 区 别 的， 但 是 最 后 你 会 发 现 ， 其 实 他 们 都 调用 底 
层 函 数 OS_Pend(0， 因 为 他 们 都 有 相似 的 功能 一 一 等 待 。 为 什么 会 需要 OS_PEND_OBJ 这 种 数据 类 型 呢 ? 如 果 要 获取 某 个 元 素 ， 直 接 取 四 种 内 核对 象 
变量 的 元 素 不 就 可 以 了 吗 ” 因 为 图 5-9 所 示 的 四 种 内 核对 象 的 数据 类 型 都 要 调用 底层 函数 ， 如 OS_Pend(0、OS_Post( 等 ， 如 果 不 将 他 们 相同 部 分 以 及 
在 底层 函数 中 必须 要 用 到 的 这 些 元 素 整合 成 一 个 共同 的 数据 类 型 ， 那 么 上 述 的 底层 函数 的 参数 输入 很 难 兼 容 图 5-9 所 示 四 种 内 核对 象 的 共同 操作 。 事 
实 上 ，HC/OSs- 吊 的 O3_Pend0、Os_Post0， 这 些 底层 函数 都 有 一 个 OS9_PEND_OBJ 类 型 的 输入 参数 。 


图 5-9 所 示 内 核对 象 相同 部 分 含义 如 下 。 
Type: 用 来 识别 内 核对 象 的 类 型 ， 可 以 是 如 表 5-1 所 示 的 几 种 类 型 。 


表 5-1 内 核对 象 类 型 






































内 核对 象 宏 定义 
无 OS_ OBJ TYPE NONE 
事件 标志 OS_OBJ TYPE FLAG 
内 存 分 区 OS OBJ TYPE MEM 
二 值 信号 量 OS_OBJ TYPE MUTEX 
消息 队列 OS OBJ TYPE Q 
信号 量 OS_ OBJ TYPE SEM 
任务 消息 OS OBJ TYPE TASK MSG 
任务 信号 量 OS_OBJ TYPE TASK_ SIGNAL 
时 钟 节 扫 OS OBJ TYPE TICK 
定时 天 OS_OBJ TYPE TMR 
这 些 宏 的 定义 非常 有 意思 ， 以 OS_OBJ_TYPE Q 为 例 : 
#define OS OBJ TYPE Q (O08 OBJ TYPE}CPY TYPE CREATE('Q, UVU', E’, "YU") 





CPU_TYPE_CREATE 又 是 什么 呢 ? 根据 他 的 定义 ， 就 是 将 4 个 字符 分 为 32 位 放 在 的 4 个 8 位 上 ， 每 个 字符 占 8 位 ，32 位 刚刚 好 。 这 样子 只 要 名 称 的 
缩写 不 一 样 ， 就 会 自动 生成 唯一 的 数值 。 其 代码 如 下 。 











1 #define CPU TYPE CREATE (char 1, char 2, char 3, char 4) (((CPU INT32U) ((CPU_ 
INT08U) (char 1)) << (0u * DEF OCTET NBR BITS)) | \ 

县 ( (CPU_INT32U) ( (CPU _ INT08U) (char 2)) << (lu * DEF OCTET NBR BITS)) | N 

3 ( (CPU_INT32U) ( (CPU INTO8U) (char 3)) << (2u * DEF OCTET NBR BITS)) | N 

4 ((CEU INT32U) ( (CPU _ INT08U) (char 4) ) << (3u * DEF OCTET NBR BITS))) 








NamePtr: 定义 的 时 候 可 以 为 每 个 内 核对 象 设置 一 个 字符 串 作 为 它 的 名 字 。 

TS: 用 于 保存 该 内 核对 象 最 后 一 次 被 释放 的 时 间 戳 。 

2) 内 核对 象 都 有 一 部 分 是 不 相同 的 ， 这 是 他 们 各 自 功 能 不 一 样 决定 的 。 下 面 简单 介绍 下 其 他 内 核对 象 不 同 的 元 素 的 含义 。 
Ctr: 用 于 信号 量 的 计数 。 

OwnerTCBPtr: 指向 拥有 互 斥 信号 量 的 任务 控制 块 指针 。 


OwnerOriginalPrio: 因为 互 斥 信号 量 为 了 解决 优先 级 反 转 的 问题 ， 会 提升 任务 的 优先 级 ， 这 个 时 候 这 个 元 素 就 将 其 开始 的 优先 级 保存 下 来 ， 后 
面 恢复 的 时 候 就 找到 这 个 就 好 了 。 


OwnerNestingCtr: HCV/OS- 山 的 互 斥 信号 量 相 对 hC/OS-lI 的 互 斥 信号 量 的 一 个 新 特性 ， 就 是 可 挫 套 ， 占 用 互 斥 信号 量 的 任务 可 以 不 断 地 抱 套 互 


斥 信 号 量 ， 释 放 时 也 要 释放 到 这 个 值 为 0 的 时 候 ， 才 算是 完全 地 释放 互 斥 信号 量 。 
Flags: 事件 标志 位 被 设置 的 情况 。 


MsgQ: 这 个 元 素 是 OS_MSG_Q 结 构 体 类 型 的 。NbrEntriesSize 是 队列 中 可 用 的 消息 个 数 ，NbrEntries 是 目前 队列 中 含有 的 消息 个 
数 ，NbrEntriesMax 是 队列 中 含有 消息 个 数 的 峰值 。 一 个 队列 既 有 输入 ， 又 有 输出 ，InPtr 指 向 输入 端的 消息 ， 方 便 插入 新 的 消息 到 队列 ，OutPtr 指 
向 队列 输出 端的 消息 。 








3) 虽然 只 是 讲解 了 信号 量 及 其 等 待 队列 之 间 的 关系 是 什么 样子 的 ， 没 有 讲解 消息 队列 等 跟 其 等 待 队 列 是 什么 样子 ， 但 看 到 他 们 之 间 的 相似 之 处 
想必 大 家 也 可 以 知道 。 


5.7 ” 友 布 信号 量 

本 书 中 有 的 时 候 也 用 提交 、post 等 词语 来 代替 发 布 一 词 ， 都 是 一 样 的 。 
1. 参 数 

其 参数 含义 如 下 。 

1) p_sem: 指向 要 提交 的 信号 量 的 指针 。 

2) opt: 发 布 信号 时 的 选项 ， 可 能 有 以 下 几 个 选项 。 

. OS_OPT_POST_1 一 一 发 布 给 信号 量 等 待 列表 中 优先 级 最 高 的 任务 。 

. OS_OPT_ POST_ALI 一 一 发 布 给 信号 量 等 待 列 表 中 所 有 的 任务 。 


" OS_OPT_POST_NO_SCHED 一 一 提交 信号 量 之 后 要 不 要 进行 任务 调度 ， 默 认 是 要 进行 任务 调度 ， 选 择 该 选项 可 能 的 原因 是 ， 想 继续 运行 当前 
， 因 为 发 布 信号 量 可 能 让 那些 等 待 信号 量 的 任务 就 绪 ， 这 个 选项 没有 进行 任务 调度 ， 发 布 完 信号 量 当前 任务 还 是 继续 运行 。 当 任务 想 发 布 多 个 信 


最 后 同时 调度 时 也 可 以 用 这 个 选项 。 可 以 跟 上 面 两 个 选项 之 一 相 与 作为 参数 。 


市 
闻 


os 
上 


3) p_err: 指向 返回 错误 类 型 的 指针 ， 错 误 的 类 型 (只 包含 部 分 ) 如 下 。 


" OS_ERR_SEM_OVF 一 一 信号 量 计数 值 已 经 达到 最 大 范围 了 ， 这 次 提交 会 引起 信号 量 计 数值 溢出 。 


2. 返 回 值 


信号 量 运行 函数 后 的 计数 值 。 


发 布 一 个 信号 量 是 一 个 很 复杂 的 操作 ，HC/OS- 吊 将 这 个 过 程 分 解 为 多 层 操作 ， 最 多 的 时 候 要 赃 套 调用 6 个 函数 。 图 5-10 所 示 的 是 发 布 信号 过 程 的 
主要 操作 ， 其 中 省 略 了 一 些 细节 ， 下 面 结合 源码 和 以 图 5-10 所 示 的 标号 顺序 进行 讲解 信号 量 发 布 的 整个 过 程 。 灰 色 背 景 框 代 表 调用 新 的 函数 ， 函 数 稍 
微 下 面 一 点 是 该 函数 的 解析 ， 在 下 一 个 灰色 背景 框 出 现 之 前 的 白色 背景 框 的 操作 都 属于 上 一 个 灰色 背景 框 代表 的 函数 。 





当 资 源 被 信号 量 保护 起 来 的 时 候 ， 想 要 使 用 资源 ， 必 须 先 调用 OSSemPend 以 确保 资源 已 经 被 释放 。 调 用 后 如 果 立 即 获得 信号 量 ， 说 明 资 源 之 前 
已 经 被 释放 ， 可 以 使 用 。 调 用 后 如 果 还 得 等 待 信号 量 释放 ， 说 明 资 源 还 没有 被 释放 ， 任 务 处 于 等 待 状 态 。 





信号 量 被 用 做 标志 事件 的 发 生 与 否 ,调用 OSSemPend 如 果 立 即 获得 信号 量 ， 说 明 事 件 已 经 发 生 ; 如 果 调 用 后 任务 等 待 信号 量 ， 意 味 着 事件 还 没 
有 发 生 。 


1. 参 数 
1) p_sem: 指向 要 获取 的 信号 量变 量 的 指针 。 
2) opt: 可 能 是 以 下 几 个 选项 之 一 。 
" OS_OPT_PEND_BLOCKING: 如 果 不 能 立即 获得 信号 量 ， 则 表示 要 继续 等 待 。 


. OS_OPT_PEND_NON_BLOCKING: 如 果 不 能 立即 获得 信号 量 ， 则 表示 不 等 待 信号 量 。 





3) timeout: 这 个 参数 设置 的 是 获取 不 到 信号 量 的 时 候 等 待 的 时 间 。 如 果 这 个 值 为 0， 表 示 一 直 等 待 下 去 ; 如 果 这 个 值 不 为 0， 则 最 多 等 待 


timeout 个 时 钟 节拍 。 
4) p_ts: 指向 等 待 的 信号 量 被 删除 、 等 待 被 强制 停止 、 等 待 超时 等 情况 时 的 时 间 戳 的 指针 。 
5) p_err: 指向 返回 错误 类 型 的 指针 ， 有 以 下 几 种 类 型 。 
" OS_ERR_OBJ_DEL: 信号 量 已 经 被 删除 。 
" OS_ERR_OBJ_PTR_NULL: 输入 的 信号 量变 量 指针 是 空 类 型 。 


" OS_ERR_OBJ_ TYPE: p_sem 指 向 的 变量 内 核对 象 类 型 不 是 信号 量 。 





- OS_ERR_OPT_INVALID: 参数 opt 不 符合 和 要求 。 
. OS_ERR_PEND_ABORT: 等 待 过 程 ， 其 他 的 任务 调用 了 函数 OSSemPendAbort 强 制 取 消 等 待 。 


" OS_ERR_PEND_ISR: 企图 在 中 断 中 等 待 信号 量 








. OS_ERR_PEND_WOULD_BLOCK: 开始 获取 不 到 信号 量 ， 且 没有 要 求 等 待 。 
. OS_ERR_SCHED_LOCKED: 调度 器 被 锁 住 。 
* OS_ERR_STATUS_INVALID: 系统 出 错 ， 导 致 任务 控制 块 的 元 素 PendStatus 不 在 可 能 的 范围 内 。 
. OS_ERR_TIMEOUT: 等 待 超 时 。 
2. 返 回 值 


信号 量 计数 值 。 


5.9 ”等 待 信号 量 过 程 的 解析 


首先 通过 图 5-13 大 致 地 看 下 等 待 信号 量 的 过 程 ， 等 待 的 过 程 相信 有 一 部 分 读者 也 能 猜 到 ， 将 函数 调用 的 全 部 过 程 放 在 这 张 图 是 为 了 让 读者 有 个 全 





局 的 观念 ， 讲 解 的 顺序 同样 是 按照 图 5-13 中 标示 的 序号 。 





将 任务 插入 节拍 列表 ， 












是 否 要 插入 等 待 列 表 


(18) 





OS_PEND_DATA 类 型 变量 
插入 到 某 种 内 核对 象 的 
等 待 队 列 





5.10 ”强制 解除 等 待 状态 


函数 OSSemPendAbort 用 来 强制 解除 任务 的 等 待 状态 。 
1. 参 数 

参数 主要 包括 以 下 几 个 。 

1) p_sem: 指向 信号 量变 量 的 指针 。 


2) opt: 强制 解除 任务 等 待 状态 的 选项 ， 可 以 为 以 下 几 种 。 









图 5-13 等待 信号 量 的 过 程 





等 待 一 个 信号 量 


(1) | 信号 量 可 用 与 否 





判断 等 待 状态 ， 找 
(11)| 出 相应 的 错误 信息 








返回 Ctr 计 数值 





图 解 


* OS_OPT_PEND_ABORT_1: 只 解除 等 待 信号 量 中 所 有 任务 中 优先 级 最 高 的 任务 。 





. OS_OPT_PEND_ABORT_ALL: 解除 等 待 信号 量 的 所 有 任务 。 


" OS_OPT_POST_NO_SCHED: 解除 等 待 状态 后 不 进行 调度 ， 这 个 选项 可 以 跟 上 面 两 个 选项 之 一 相 与 。 


3) p_err: 指向 错误 类 型 的 指针 ， 主 要 有 以 下 几 种 类 型 。 


. OS_ERR_NONE: 没有 错 


首 误 。 


- OS_ERR_OBJ PTR_NULL: 输入 参数 p_sem 是 空 指针 。 


" OS_ERR_OBJ_ TYPE: 输入 参数 p_sem 指 向 的 内 核对 象 不 是 信号 


- OS_ERR_OPT_INVALID: 输入 的 参数 opt 不 可 用 。 


量 


o 


OS_ERR_PEND_ABORT ISR: 从 中 断 中 调用 OSSemPendAbortt 函 数 。 





“ OS_ERR_PEND_ABORT_NONE.: 


没有 任务 在 等 待 信号 量 





2. 返 回 值 


解除 等 待 状态 的 任务 个 数 。 


看 到 解析 强制 解除 等 待 状态 的 源码 ( 见 代码 清单 5-17) 的 时 候 可 能 会 感到 很 熟悉 ， 可 以 说 ， 
任务 差不多 的 。 信 号 量 提交 的 时 候 如 果 有 任务 在 等 待 ， 那 么 内 核 要 将 这 些 任务 都 解除 等 待 状态 ， 


个 是 因为 信号 量 提交 而 解除 ， 一 个 是 强制 解除 ， 所 以 细节 方面 还 是 有 细微 的 差别 。 如 果 前 面 已 
待 状态 的 过 程 应 该 完全 没有 问题 ， 否 则 应 该 将 前 面 讲解 信号 量 提交 的 章节 再 好 好 理解 才 行 。 


o 


代码 清单 5-17 ”强制 解除 等 待 状态 的 函数 OSSemPendAbort 


#if OS CFG SEM PEND ABORT EN > 0u 





OS_ PEND LIST 


OS _ OBJ QTY OSSemPendAbort 


(OS_SEM 
OS_OPT 
OS_ ERR 


*p_sem, 
opt, 
*p_err) 


*p pend list; 





OS_TCB 
CPU TS 

OS _ OBJ QTY 
CPU SR ALLOC(); 


xp 


nb 


#ifdef OS APETY 2 CRIT 
了 (P err == (OS ] 

OS SAFETY CRI' 

return ( (OS i (®) 








} 
#endif 


#if OS CFG CALLED FROl 


ts; 


tob; 


r tasks; 


ICAL 
ERR *)0) { 
TICAL EXCEPTION (); 
BJ QTY) 0u); 


ISR CHK EN > 0u 





if (OSIntNestingC 
oSrE = OS 
return ((OS ( O 


} 
#endif 


NINDIDINDNDINDRNDHFRFRFRFRHFRFRFR FF 
OONPOOOOOOPOVONPO(ULOAIOOPODP 


tr > (OS NESTING CTR)Ou) { 
ERR PEND . ABORT . ISR; 
BJ OTY) 0u); 














28 #if OS _ CFG ARG ( CH EN > 0u 

29 i (p_sem = 一 (OS | SEM *)0)} { 

30 “Derr = ‘08 ,ERR OBJ PTR NULL; 

3 return ((OS OBJ OTY) 0u); 

32 } 

33 switch (opt) { 

34 case OS OPT PEND ABORT 1: 

35 case OS OPT PEND ABORT ALL: 

36 break; 

37 

38 defauilt: 

39 *p err = OS ERR OPT INVALID; 

40 return ((OS ( OBJ OTY) 0u); 

41 } 

42 #endif 

43 

44 #if OS CFG OBJ TYPE CHK EN > 0u 

45 if (p sem->Type != OS OBJ TYPE SEM) { 
46 xp err = OS ERR OBJ TYPE; 

47 return ((OS OBJ CTY) 0u) ; 

48 } 

49 #enqif 

50 

S51 CPU_CRITICAL ENTER(); 

52 // 取出 等 待 队列 管理 变量 

| p pend list = &p sem->PendList; 

54 人 等 待 列 表 上 等 待 的 任务 如 果 为 0， 则 直接 退出 
55 if (p pend list->NbrEntries == (OS OBJ QTY) 0u) 
56 CPU _ CRITICAL EXIT(); 

57 *p err = OS ERR PEND ABORT NONE.; 





言 号 量 的 提交 过 


这 跟 强 制 解除 


径 完全 明白 了 


主 已 旦 . 
互 三 星 : 


住 电量: 
百 呈 星 : 过 程 是 


旦 部 分 是 跟 强 制 解除 信号 量 上 等 待 的 
是 一 样 的 ， 只 是 由 于 一 


是 交 的 过 程 ， 现 在 理解 强制 解除 等 


58 return ((OS OBJ QTY) 0u) ; 











59 ， 

60 

61 OS CRITICAL ENTER CPU CRITICAL EXIT(); 

62 nbr tasks = Ou; 

63 ts = OS_ TS GET(); 

64 while (p pend list->NbrEntries > (OS OBJ QTY)Ou) { 
65 // 取出 第 一 个 任务 

66 p tcb = p pend list->HeadPtr->TCBPtr; 

67 // 将 任务 一 个 个 移 除 

68 OS_ PendAbort ( (OS_PEND OBJ *) ((void *)p sem), 
69 p tcb, 

70 ts) 

71 nbr tasks+tt+; 

72 if (opt != OS OPT PEND ABORT ALL) { 

73 break; 

74 } 

75 } 

76 OS CRITICAL EXIT NO SCHED(); 

77 

78 // 根据 选项 决定 是 否 调度 

79 if ((opt & OS OPT POST NO SCHED) == (OS OPT)0u) { 
80 Ossched(); 

81 } 

82 

83 *p err = OS ERR NONE; 

84 return (nbr tasks); 

85 } 

86 #engif 


函数 OSsemPendAbort 首 先 检查 等 待 信号 量 的 任务 个 数 ，NbrEntries 变 量 保存 着 等 待 信号 量 的 任务 个 数 ， 所 以 只 要 判断 NbrEntries 即 可 ， 如 果 
没有 等 待 信号 量 的 任务 ， 直 接 退 出 。 


接着 在 循环 里 面 将 信号 量 上 的 任务 一 个 个 解除 ， 这 个 操作 主要 是 循环 调用 OS_PendAbort 函 数 ， 其 他 的 内 核对 象 ， 消 息 队 列 ， 时 间 标 志 等 强制 解 
除 等 待 任务 的 时 候 最 后 也 是 调用 这 个 函数 。 每 解除 一 个 等 待 的 任务 就 将 变量 nbr tasks 加 1， 最 后 作为 返回 值 返 回 ， 通 过 返回 值 就 可 以 知道 一 共 解 除了 
等 待 信号 量 上 的 多 少 个 任务 。 根 据 选项 来 解除 信号 量 的 个 数 ， 如 果 选 项 是 OS_OPT_PEND_ABORT_ALL， 那 就 将 等 待 信号 量 的 全 部 任务 都 解除 等 待 状 
态 ， 如 果 选 项 是 OS_OPT_PEND_ABORT_1， 就 只 是 解除 信号 量 上 优先 级 最 高 的 那个 任务 ， 所 以 在 进入 循环 执行 一 次 后 就 跳出 循环 了 。 最 后 根据 选项 
选择 是 否 进行 任务 的 调度 。 


5.11 删除 信号 量 


冰 数 OSSemDel 用 来 删除 信号 量 ( 见 代码 清单 5-20) ， 使 用 之 前 首先 要 将 OS_CFG_SEM_DEL EN 这 个 宏 置 1， 注 意 调用 这 个 函数 后 ， 之 前 用 信和 号 
量 保护 的 资源 将 不 再 得 到 保护 。 


1. 参 数 
1) p_sem: 指向 信号 量变 量 的 指针 。 
2) opt: 删除 信号 量 时 候 的 选项 ， 有 以 下 两 个 选择 。 


“ OS_OPT_DEL_NO_PEND 一 一 当 信号 量 的 等 待 列表 上 面 没 有 相应 的 任务 的 时 候 才 删除 信号 量 。 





管 信号 量 的 等 待 列 表 是 否 有 相应 的 任务 都 删除 信号 量 。 
3) p_err: 指向 返回 错误 类 型 的 指针 ， 有 以 下 几 种 可 能 。 

* OS_ERR_DEL, ISR 一 一 企图 在 中 断 中 删除 信号 量 。 

" OS_ERR_OBJ_PTR_NULI 一 一 参数 p_sem 是 空 指针 。 

" OS_ERR_OBJ_TYPE 一 一 参数 p_sem 指 向 的 内 核 变量 类 型 不 是 信号 


“ OS_ERR_OPT_INVALID 





opt 在 给 出 的 选项 之 外 


` OS_ERR_TASK_WAITING 一 一 在 选项 opt 是 OS_OPT_DEL NO_PEND 的 时 候 ， 并 且 信号 量 等 待 列表 上 有 等 待 的 任务 。 


2. 返 回 值 


删除 信号 量 的 时 候 ， 会 将 信号 量 等 待 列 表 上 的 任务 脱离 该 信号 量 的 等 待 列 表 。 返 回 值 表 示 的 就 是 脱离 等 待 列 表 的 任务 个 数 。 


没有 见 删除 信号 量 相关 代码 之 前 ， 让 我 们 先 猜想 下 删除 信号 量 的 操作 流程 ， 删 除 信号 量 首先 可 能 会 先 让 信号 量 等 待 列 表 上 的 所 有 任务 脱离 等 待 列 
这 部 分 我 们 在 前 面 的 发 布 信号 跟 强 制 解除 内 核对 象 上 的 任务 这 两 个 过 程 会 差不多 ， 然 后 再 对 信号 量变 量 进行 一 些 清空 操作 。 


代码 清单 5-20 ”删除 信号 量 函 数 OSsemDel 


















































1 #if OS CFG SEM DEL EN > Ou 
2 OS OBJ QTY OSSemDel (OS SEM *p sem, 
OS_OPT apt 
4 OS ERR *p err) 
3 
6 OS_OBJ QTY cnt; 
J OS OBJ QTY nbr tasks; 
8 OS PEND DATA *p pend data; 
9 OS PEND LIST *p pend list; 
0 OS_TCB xp teb; 
是 CPU TS ts; 
2 CPU SR ALLOC(); 
3 
4 
| 
6 #ifdef OS BATE A CRITICAL 
7 了 和 (P err =— (OS ERR *)0) { 
18 OS_SAFETY CRITICAL ! EXCEPTION (); 
19 return ((OS OBJ QTY) 0 jy 
20 J 
21 #endif 
22 
23 #if OS CFG CALLED FROM ISR CHK EN > 0u 
24 if (OSIntNestingCtr > (OS NESTING CTR) 0) { 
25 *p err = OS ERR DEL ISR; 
26 return ((OS OBJ QTY)0); 
27 ， 
28 #endif 
29 
30 #if OS CFG ARG CHK EN > 0u 
31 if (p sem == (OS SEM *)0) { 
32 *p err = OS ERR OBJ PTR NULL; 
33 return ((OS OBJ QTY)0); 
34 } 
35 #engif 
36 
37 #if OS CFG OBJ TYPE CHK EN > 0u 
38 if (p sem->Type != OS OBJ TYPE SEM) { 
39 *p err = OS ERR OBJ TYPE; 
40 return ((OS OBJ QTY)0); 
41 } 
42 #engif 
43 
44 CPU _ CRITICAL ENTER(); 
45 P ] penqd _ list = &p sem->PendList; 
46 cnt = p pend list->NbrEntries; 
47 nbr tasks = cnt; 
48 Switch (opt) { 
49 // 如 果 要 在 没有 任务 等 待 信号 量 的 时 候 才 删除 信号 量 
50 case 08 OPT DEL NO PEND: 
51 // 等 待 的 任务 个 数 为 0 
52 if (nbr tasks == (OS OBJ QTY)0) { 
53 #if OS CFG DBG EN > Ou 
54 // 将 信号 量 从 调试 列表 的 双向 链表 中 删除 
55 OS_SemDbgListRemove (p_ sem); 
56 #engdif 
57 // 将 信号 量 的 个 数 减 1 
58 OSSemQty-—-—; 
59 
60 // 清空 信号 量 的 信息 
61 OS_ SemClr (p sem); 
62 CPU CRITICAL EXIT(); 
63 *p err = OS ERR NONE; 
64 } else { 
65 CPU CRITICAL EXIT(); 
66 *p err = OS ERR TASK WAITING; 
67 } 
68 break; 
69 
70 case OS OPT DEL ALWAYS : 
了 2 CRITICAL ENTER CPU CRITICAL EXIT(); 
72 = OS TS GET(); 
73 7 一 个 不 将 全 待 列表 上 的 任务 删除 
74 while (cnt > 0u) { 
.3 p pend data = : pend list->HeadPtr; 
76 p_tcb = p pend data->TCBPtr; 
了 7 65 Pendobjpel ((0 Ss PEND ) OBJ *) ((void *)p sem), 
78 Pb toeb, 
79 ts); 
80 cnt——;} 
81 } 
82 #if OS CFG DBG EN > 0u 
83 // 将 信号 量 从 调试 列表 的 双向 链表 中 删除 
84 OS_SemDbgListRemove (p_sem); 
85 #engif 


86 OSSemOty-—-; 


87 OS_SemClr (P_sem) 








88 OS CRITICAL EXIT NO SCHED() 
89 OSsched(); 

90 *p_err = OS ERR NONE; 

91 break; 

92 

93 defauilt: 

94 CPU CRITICAL EXIT(); 

95 *p err = OS ERR OPT INVALID; 
96 break; 

97 } 

98 return ((OS OBJ QTY)nbr tasks); 
89 叶 

100 #endif 


函数 OSSemDel 首 先 获取 信号 量 等 待 列表 上 等 待 的 任务 个 数 ， 接 下 来 对 参数 opt 进 行 分 类 处 理 ， 如 果 opt 是 OS_OPT_DEL_NO_PEND 的 话 ， 表 示 
要 在 没有 任务 等 待 信号 量 的 时 候 才 可 以 删除 信号 量 ， 所 以 52 行 首先 判断 信号 量 上 等 待 的 任务 个 数 是 不 是 9， 如果 大 于 0， 直 接 返 回 错误 。 
OS_SemDbgListRemove 将 信号 量 从 调试 的 双向 链表 中 删除 ， 前 面 已 经 介绍 过 具体 的 操作 过 程 。 最 后 将 记录 信号 量 个 数 的 全 局 变量 OSSemQty 减 1。 
Os _semClr 也 是 非常 简单 的 函数 ， 其 功能 就 是 清空 信号 量 的 内 容 ， 而 且 会 清空 挂 起 队列 ， 源 码 如 代码 清单 5-21 所 示 。 








代码 清单 5-21 ”清空 信号 量变 量 冰 数 OS_ SemClr 


1 void OS SemClr (OS SEM *p sem) 

2 { 

3 p_sem->Type = OS_ OBJ TYPE NONE; 

4 p_sem->Ctr = (OS SEM CTR) 0 

号 P_sem->TS = (CPU ， TS ) 0 

6 p_sem->NamePtr = (CPU ， CHAR *) (tvoid My 
7 OS_ PendListInit (gp : sem->PendList); 

中 


代码 清单 5-22 ”清空 等 待 列 表 函 数 OS_PendListInit 





void OS PenqListInit (OS PEND LIST *p pend list) 
{ 


p_pengd list->HeadPtr 


1 

2 

从 (OS_PEND DATA *)0; 
4 p_pengd list->TailPtr 

bs] 

6 


0 
(OS_PEND DATA *)0; 
(0S OBJ OTY )0 


pengd list->NbrEntries 


了 


} 


当 输 入 参数 选项 opt 是 OS_OPT_DEL ALWAYS 的 时 候 ， 即 使 有 等 待 信号 量 的 任务 ， 也 会 删除 信号 。 删 除 之 前 ， 先 要 删除 信号 量 的 等 待 列表 ( 见 代 
码 清单 5-22) 。66~73 行 在 循环 中 依次 将 等 待 列 表 上 的 节点 一 个 个 删除 ， 这 些 节点 即 是 OS_PEND_DATA 结 构 体 变量 ， 见 图 5-3。 在 开始 讲解 删除 信 
号 量 的 时 候 ， 我 们 对 整个 流程 做 了 猜想 ， 猜 删除 信号 量 部 分 操作 会 跟 OS_Post 和 OS_PendAbort 差 不 多 ， 这 个 函数 OS pendObjpelxn 代 码 清单 5.23 
所 示 。 








代码 清单 5-23 ”删除 信号 量 节 点 函数 OS_PendObjDel 
































1 void OS PendOobjDel (OS_ PEND OBJ *p_obj， 

2 OS_TCB *p: teby 

3 ecPEU TS ts) 

4 1{ 加 

Switch (p tcb->TaskState) { 

6 case OS TASK STATE RDY: 

3 case OS TASK STATE DLY: 

8 case OS TASK STATE SUSPENDED: 

9 case OS TASK STATE DLY SUSPENDED: 

10 break; 

1 

2 case OS_ TASK STATE PEND: 

3 case OS_ TASK STATE PEND TIMEOUT: 

4 if (pi tcb->Pendon == OS TASK PEND ON MULTI) { 
5 OS_PendOobjDell (p_obj, 

6 p_tcb, 

7 ta) 

8 } 

19 #if (OS MSG EN > 0u) 
20 p_tcb->MsgPtr = (void *)0; 
21 p tcb->MsgSize = (OS MSG SIZE) Ou; 
22 #endif ee 
23 pteb~>LTS = 3 
24 OS_PendListRemove (p tcb); 
25 OS TaskRdy (p - teb)y 
26 p_ tcb->TaskState = OS TASK STATE RDY; 
27 p tcb->PendStatus = OS STATUS PEND DEL; 
28 p_tcb->Pendon = OS_TASK PEND ON NOTHING; 
29 break; 

30 

31 case OS_ TASK STATE PEND SUSPENDED: 

32 case OS TASK STATE PEND TIMEOUT SUSPENDED: 
33 if (p tcb->Pendon == OS_ TASK PEND ON MULTI) { 


34 OS_PendOobjDell (p_obj, 


39 BD toeb, 





36 ts); 

37 } 

38 #if (OS MSG EN > 0u) 

39 Pp_tcb->MsgPtr = (void Os 

40 P_tcb->MsgSize = (OS MSG SIZE) Ou; 

41 #endif 

42 p_tcb->TS = ts; 

43 OS _ TickListRemove (p tcb); 

44 OS_PendListRemove (p_ tcb); 

45 Pp tcb->TaskState = OS TASK STATE SUSPENDED; 
46 p tcb->PendSstatus = OS STATUS PEND DEL; 

47 p_tcb->Pendon = OS_ TASK PEND ON NOTHING; 
48 break; 

49 

50 gdefault: 

3 break; 

52 } 

53 } 


看 到 上 面 代码 清单 5-23 中 删除 信号 量 节点 函数 OS_PendObjDel 的 代码 ， 可 能 大 家 都 不 属 去 看 了 ， 具 体 参 见 前 面 的 函数 OS_Post 和 
OS_PendAbort， 他 们 之 间 区 别 最 大 就 是 27、46 行 了 ， 表 示 任 务 是 因为 内 核对 象 被 删除 而 解除 等 待 状态 的 。 这 三 者 没有 太 大 区 别 是 因为 他 们 都 是 解除 
等 待 状态 。 虽 然 可 能 是 因为 信号 量 提交 ,或 者 强制 解除 等 待 状态 的 ,或 者 信号 量 被 删除 。 


5.12 ”设置 信号 量 计数 值 








OSSemSet 可 以 将 信号 量 的 计数 值 设置 为 任意 值 ， 但 是 前 提 是 没有 任务 在 等 待 信号 量 。 如 果 有 任务 在 等 待 信号 ， 修 改 信 号 量 计 数值 后 可 能 会 让 任 
务 就 绪 ， 但 是 uC/OS-ll 没 有 设置 这 么 复杂 的 功能 ， 其 源码 见 代码 清单 5-24。 


参数 
1) p_sem: 指向 信号 量 参数 的 指针 。 
2) cnt: 要 设置 的 计数 值 。 


3) p_err: 指向 返回 的 错误 类 型 的 指针 ， 可 能 有 以 下 几 种 类 型 。 





没有 错误 。 
. OS_ERR_OBJ PTR_NULIL 一 一 参数 p_sem 是 个 空 指针 。 


向 的 内 核对 象 变量 的 类 型 不 是 信号 量 。 





* OS_ERR_TASK_WAITING 一 一 如 果 等 待 信号 量 的 任务 是 不 可 以 设置 信号 量 计 数值 的 。 


代码 清单 5-24 ”设置 信号 量 计 数值 函数 OSssemset 


voidq OSSemSet (OS SEM *p_sem, 
OS SEM CIR cnt, 
OS ] ERR EPE 


OS PEND LIST *p pend list; 
CEU SR ALLOC(); 





3 (P err =— (OS ERR *)0) { 
OS_SAFETY ( CRITICAL ， EXCEPTION (); 
return; 





} 
#endif 


#if OS CFG CALLED FROM ISR CHK EN > Ou 
if (OSIntNestingCtr > (OS NESTING CTR)0) { 





1 
2 
3 
4 
Ee 
6 
由 
8 
9 
10 #ifdqef OS CRITICAL 
于 
人 2 
3 
4 
3 
6 
| 
8 
9 





*p err = OS ERR SET ISR; 





20 return; 

21 } 

22 #engdif 

23 

24 #if OS _ CFG ARG EN 0 志 

25 EE。 (p_sem == (OS SEM *)0) { 

26 *p err = OS ERR OBJ PTR NULL; 





27 return; 











28 } 

29 #endif 

30 

31 #if OS CFG OBJ TYPE CHK EN > 0u 

32 if (p sem->Type != OS OBJ TYPE SEM) { 
33 *p err = OS ERR OBJ TYPE; 

34 return; 

35 } 

36 #engif 

37 

38 xp err = OS ERR NONE; 

39 CPU_ CRITICAL ENTER(); 

40 if {p sem->Ctr > (OS SEM CTR)0) { 

41 Pp_sem->Ctr = cnt; 

42 } else 

43 p pend list = &p sem->PengList; 
44 if (p pend list->NbrEntries == (OS OBJ QTY)0) { 
45 p_sem->Ctr = cnt; 

46 } else { 

47 *p_err = OS ERR TASK WAITING; 
48 } 

49 } 

50 CPU_ CRITICAL EXIT (); 

51 才 


代码 清单 5-24 中 设置 信号 量 计数 值 的 这 个 函数 Ossemset 的 运行 流程 也 非常 的 简单 ， 如 果 计 数值 大 于 0， 这 个 在 正常 情况 下 也 不 可 能 出 现任 务 还 
在 等 待 信号 量 的 情况 。 如 果 计 数值 等 于 0， 就 要 先 判 断 是 否 有 任务 在 等 待 信号 量 ， 如 果 没有 才 可 以 设置 ， 不 然 返 回 错误 。 为 什么 这 个 流程 一 定 要 保证 
没有 任务 在 等 待 信号 量 呢 ? 比如 当 有 任务 在 等 待 信号 量 ， 而 这 个 信号 量 的 计数 值 被 从 一 开始 的 0 设置 为 大 于 0 的 数 ， 这 个 时 候 等 待 的 任务 应 该 解除 等 待 
状态 ， 然 而 由 于 函数 中 没有 准备 相应 解除 等 待 状 态 的 代码 ， 所 以 只 能 退 而 求 其 次 。 如 果 这 个 函数 要 设计 为 有 等 待 的 任务 的 时 候 也 可 以 设置 的 话 ， 就 要 
引用 类 似 信号 量 发 布 的 相关 代码 。 





5.13 总结 


/GAN2 口 


本 章 讲解 了 信号 量 的 多 个 操作 ， 这 些 操作 和 数据 结构 十 分 复杂 ， 但 是 设计 得 非常 有 层次 ， 比 如 信号 量 的 提交 从 开始 的 多 个 任务 脱离 多 个 等 待 列 
表 ， 到 一 个 任务 脱离 多 个 等 待 列 表 ， 最 后 再 到 一 个 任务 脱离 一 个 等 待 列 表 ， 这 个 过 程 由 繁 到 简 ， 突 显 层次 。 这 个 时 候 我 们 就 可 以 回答 我 们 之 前 提 到 的 
问题 ， 为 什么 提交 一 个 信号 量 可 以 让 其 他 的 任务 就 绪 ? 因为 提交 信号 量 不 是 信号 量 的 计数 值 减 1 这 样子 简单 的 操作 ， 还 加 上 等 待 列表 的 管理 还 有 任务 
调度 ， 这 样 才 就 可 以 达到 效果 。 信 和 号 量 的 重要 性 还 在 于 它 背 后 的 等 待 列 表 ， 用 来 管理 等 待 的 任务 。 





等 待 信号 量 的 操作 可 以 简单 总 结 为 一 开始 就 查看 信号 量 是否 可 用 ， 可 用 直接 获取 ， 如 果 不 可 用 且 人 允许 调度 ， 后 面 将 任务 置 于 等 待 状态 ， 并 将 其 指 
向 这 个 任务 的 OS_PEND_DATA 类 型 变量 插入 双向 链表 中 去 ， 之 后 进行 任务 调度 ， 等 待 任务 被 剥夺 CPU 使 用 权 。 


信号 量 强制 解除 等 待 的 时 候 首先 根据 调用 函数 OSSemPendAbort 时 的 选项 首先 进行 整理 ， 比 如 是 要 解除 信号 量 上 所 有 等 待 的 任务 还 是 只 是 优先 
级 最 高 的 任务 等 ， 然 后 对 不 同 任务 状态 的 任务 进行 分 类 处 理 ， 最 后 对 将 任务 脱离 等 待 列 表 ， 这 个 过 程 前 面 发 布 信号 的 过 程 已 经 讲解 得 很 详细 ， 这 里 就 
没有 讲解 。 不 知道 大 家 有 没有 体会 到 hC/OS- 吊 对 函数 进行 合适 的 分 层 所 带 来 的 好 处 ， 分 层 虽 然 让 开始 的 程序 设计 显得 更 加 的 复杂 ， 但 是 后 面 的 程序 
设计 由 于 前 面 已 经 设计 了 很 多 相同 的 操作 ， 比 如 将 一 个 任务 从 它 等 待 的 所 有 内 核对 象 的 等 待 列 表 中 删除 的 函数 Os_PendListRemove， 后 面 只 要 进行 
适当 的 调用 即 可 ， 还 减少 了 代码 量 。 这 也 是 我 们 从 hC/OS- 吊 源码 当中 学 到 的 ， 要 对 设计 的 程序 进行 合理 的 分 层 。 后 面 介 绍 其 他 的 内 核对 象 跟 本 章 信 
号 量 的 相同 操作 的 时 候 ， 希 望 读 者 可 以 细 细 体会 这 点 。 


如 果 你 认真 地 看 完了 这 章 的 全 部 内 容 ， 相 信 接 下 来 的 几 章 肯定 很 容易 理解 。 后 面 几 章 讲解 的 时 候 侧重 对 比 跟 多 值 信号 量 不 同 的 部 分 。 


第 6 章 ” 互 斥 信号 量 mutex 


本 章 中 的 互 斥 信号 量 全 部 称 为 nutex，mutex 的 存在 是 为 了 解决 优先 级 反 转 的 问题 。 由 于 很 多 操作 跟 多 值 信号 量 是 一 致 的 ， 所 以 本 章 省 略 这 癌 
分 ,如 OS_PendObjDel。 如 果 看 源码 有 不 明白 的 地 方 ， 请 参见 第 5 章 信 号 量 的 操作 。 


6.1_mutex 变 量 的 数据 结构 


由 图 6-1 可 知 ， 结 构 体 类 型 OS_MUTEX 包 含 大 部 分 跟 信 号 量 一 样 的 元 素 ， 因 为 它们 都 有 等 待 队 列 ， 所 以 都 有 元 素 OS_PEND_LIST， 这 是 由 它们 之 
间 相同 的 功能 和 属性 决定 的 。 接 下 来 介绍 结构 体 类 型 OS_MUTEX 特 有 的 元 素 。 


互 斥 信号 量 
OS_MUTEX 


NamePtr 


OS PEND LISTI! NbrEntries ee 
OS PEND OB] - HeadPtr | 


| i | 
DbgPrevPt | 
| DbeNextPtr | 

| 


TS 





Ownerl CBPtr 


OwnerOrieimalPtr 


OwnerNestingCtr 


图 6-1 互 斥 信号 量 数 据 结构 


. OwnetTCBPtr: 这 个 元 素 记 录 了 唯一 拥有 mutex 的 任务 控制 块 指 针 。 


:OwnetOtiginalPtr: 在 任务 准备 等 待 mutex， 即 调用 OSMutexPend 的 时 候 ， 系 统 会 调整 拥有 mutex 任 务 的 优先 级 ， 当 任务 发 布 信号 量 的 时 候 ， 要 还 
原 拥 有 mutex 任 务 的 优先 级 。 这 个 变量 保存 了 优先 级 改变 之 前 的 优先 级 ， 以 便 还 原 时 操作 。 


OwnerNestingCtr: 任务 不 仅 可 以 占用 mutex， 还 可 以 多 层 座 套 ， 即 当 得 到 Mutex 的 使 用 权时 ， 还 可 以 继续 使 用 OSMutexPend 兄 数 来 获取 信号 。 每 
使 用 一 次 OSMutexPend， 这 个 元 素 就 会 加 1， 如 果 其 他 任务 要 获取 这 个 mutex， 则 要 拥有 这 个 mutex 的 任务 多 次 调用 OSMutexPost 直 到 OwnerNestingCtr 为 
0 才 可 。 可 以 说 OwnerNestingCtr 数 值 越 大 ， 表 示 任 务 对 整个 mutex 拥 有 的 程度 越 高 。 


6.2 创建 mutex 


用 函数 OSMutexCreate 来 创建 mutex ( 见 代 码 清单 6-1) ， 其 参数 包含 以 下 3 种 。 

1) p_mutex: 指向 mutex 变 量 的 指针 。 

2) p_name: 指向 mutex 变 量 名 字符 串 的 指针 。 

3) p_err: 指向 返回 错误 类 型 指针 ， 主 要 有 以 下 几 种 类 型 (只 包含 部 分 ) 。 

" OS_ERR_CREATE_ISR: 任务 企图 在 中 断 中 引用 mutex 创 建 函数 。 

 OS_ERR_NAME: 参数 p_name 是 空 指针 。 

* OS_ERR_OBJ CREATED: mutex 变 量 已 经 被 创建 ,但 是 OSMutexCreate 另 数 中 没有 涉及 这 个 错误 的 相关 代码 。 
" OS_ERR_OBJ_PTR_NULL: 变量 p_mutex 是 空 指针 。 


代码 清单 6-1 互 斥 信号 量 创建 函数 OSM utexCreate 





1 void OSMutexCreate (OS MUTEX *p mutex, 
CPU_CHAR *p_name, 
OS_ERR RE) 


CPU SR_RALLOC (); 


#ifdef OS_SAFETY CRITICAL 





if (p err 一 (OS ERR *)0) { 
OS_SAFETY CRITICAL EXCEPTION(); 
return; 
} 
#engdif 


#ifdef OS_SAFETY CRITICAL IEC61508 
if (OSSafetyCriticalStartFlag == DEF TRUE) { 
*p err = OS ERR ILLEGAL CREATE RUN TIME; 
return: 








} 
#endif 


#if OS CFG CALLED FROM ISR CHK EN > Ou 
if (OSIntNestingCtr > (OS NESTING CTR) 0) { 
*p err = OS ERR CREATE ISR; 
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~ONOUOwNDDHhPODioo 一 OwnhPhODoo ~ OO 性 N 





return; 

} 

28 #endif 

29 

30 #if OS CFG ARG CHK EN > 0u 

1 if (p mutex == (OS MUTEX *)0) { 

22 *p err = OS ERR OBJ PTR NULL; 

33 return; 

34 } 

35 #engif 

36 

37 CPU_CRITICAL ENTER(); 

38 p_mutex->Type = OS OBJ TYPE MUTEX; 

39 Pp_mutex->NamePtr = P name; 
Pp_mutex->OwnerTCBPtr = (OS_TCB SD 
p_ mutex->OwnerNestingCtr = (OS NESTING CTR)O; 
P_mutex->TS = (GPU TS )0; 


p_mutex->OwnerOriginalPrio OS_CFG PRIO MAX 
OS_ PendListInit (gp mutex->PendList); 


心心 心心 心心 心心 
OOWDNPO 


#if OS CFG DBG EN > 0u 

OS_ MutexDbgListAdd (p mutex); 
48 #endif 
49 OSMutexQty++; 


50 


下 CPU_ CRITICAL EXIT () 7 
52 xp err = OS ERR NONE; 
53 3} 





代码 清单 6-1 中 的 互 斥 信号 量 创建 函数 OSMutexCreate 相 比 于 多 值 信号 量 的 创建 函数 ODSgsemCreate， 少 了 参数 cnt。 因 为 二 值 信号 量 只 能 用 来 保 


护 资源 ， 初 始 值 用 0 来 表示 信号 量 是 可 用 的 。 


6.3 提交 mutex 


用 函数 OSM utexPost 来 提交 mutex， 前 提 是 先 拥 有 mutex， 具 体 参 数 信息 如 下 ， 源 码 如 代码 清单 6-2 所 示 。 

1) p_mutex: 指向 mutex 变 量 的 指针 。 

2) opt: 提交 mutex 时 的 选项 ， 可 包含 以 下 两 种 。 

" OS_OPT_POST_NO_SCHED: 发 布 mutex 后 不 要 进行 调度 

OS_OPT_POST_NONE: 为 默认 选项 ， 发 布 mutex 后 进行 任务 调度 。 

3) p_err: 指向 返回 错误 类 型 指针 ， 主 要 包含 以 下 几 种 类 型 (只 包含 部 分 ) 。 

" OS_ERR_MUTEX_NESTING: mutex 被 发 布 后 ， 仍 然 处 于 庶 套 中 ， 妈 前面 提 到 的 元 素 OwnerNestingCtr 还 不 为 0，mutex 还 不 能 为 其 他 任务 占有 。 


“OS_ERR_MUTEX_NOT_OWNER: 只 有 拥有 mutex 的 任务 才 可 以 释放 这 个 mutex。 当 在 一 个 不 是 拥有 mutex 的 任务 中 释放 mutex 的 时 候 ， 返 回 这 


个 错误 。 





" OS_ERR_OBJ_PTR_NULL: 参数 p_mutex 是 空 指针 。 
" OS_ERR_OBJ_TYPE: 参数 p_mutex 指 向 的 内 核 变量 类 型 不 是 mutex。 
. OS_ERR_POST_ISR: ISR 不 是 任务 ,不 可 能 拥有 一 个 mutex， 所 以 也 不 能 在 中 断 中 提交 mutex。 


代码 清单 6-2 ”提交 mutex 函 数 OSMutexPost 


























1 voiqd OSMutexPost (OS MUTEX *p mutex, 
2 Os_OPT opt, 
3 OS_ERR “DSEE) 
4{ 
5 OS PEND LIST *p pend list; 
6 OS_TCB *p tcb; 
7 CPU TS ts; 
8 CPU SR ALLOC(); 
9 
10 
这 二 
12 #ifdef OS SAPETY CRITICAL 
13 if (P err == (OS PRR *)0) { 
14 OS_SAFETY ( CRITICAL ,EXCEPTION (); 
15 return; 
16 } 
17 #engdif 
18 
19 #if OS CFG CALLED FROM ISR CHK EN > 0u 
20 if (OSIntNestingCtr > (OS NESTING CTR) 0) { 
21 *p err = OS ERR POST ISR; 
22 returriy 
3 } 
24 #endif 
25 
26 #if OS CFG ARG CHK EN > 0u 
27 了 (p_mutex == (OS MUTEX *)0) { 
28 *p err = OS ERR OBJ PTR NULL; 
29 return; 
30 } 
31 #enqif 
32 
33 #if OS CFG OBJ TYPE CHK EN > 0u 
34 if (p mutex- >Type != OS OBJ TYPE MUTEX) { 
35 *p err = OS ERR OBJ TYPE; 
36 return; 
37 


38 #enqif 


39 














40 CPU_CRITICAL ENTER(); 

41 

42 // 检查 提交 信号 量 的 任务 是 不 是 拥有 互 斥 信号 量 的 任务 ， 若 不 是 ， 则 不 能 进行 提交 操作 ， 直 接 返 回 
43 if (OSTCBCurPtr != p mutex->OwnerTCBPtr) { 

44 CPU _ CRITICAL EXIT(); 

45 *p err = OS ERR MUTEX NOT OWNER; 

46 return; 

47 } 

48 

49 2 CRITICAL ENTER CPU CRITICAL EXIT(); 

50 = OS TS a 

51 7 暂时 存放 提交 时 的 时 间 稚 

52 P_mutex->TS = ts; 

53 // 府 套 层 数 减 ] 

54 p_mutex->OwnerNestingCtr-——; 

55 // 诬 套 层 数 为 0， 即 互 斥 信号 量 可 用 

56 if (p mutex->OwnerNestingCtr > (OS NESTING CTR)0) { 
3 OS5_CRITICAL EXIT(); 

58 *p err = OS ERR MUTEX NESTING; 

59 return; 

60 } 

61 // 找 出 等 待 列表 

62 p pend list = &p mutex->PendList; 

63 

64 // 如 果 没 有 等 待 互 斥 信号 量 的 任务 ， 则 清空 互 斥 信 号 量变 量 内 容 后 返回 。 
65 if (p pend list->NorEntries == (OS OBJ QTY)0) { 

66 Pp_mutex->OwnerTCBPtr = (OS TCB Os 
67 p mutex->OwnerNestingCtr = (OS NESTING CTR)O; 

68 OS_CRITICAL EXIT(); 

69 *p_ err = OS ERR NONE; 

70 return; 

31 } 

72 
人 
74 操 

73 if (OSTCBCurPtr->Prio != p mutex->OwnerOriginalPrio) { 
76 // 将 任务 从 就 绪 列 表 中 移 除 

73 OS_RdyListRemove (OSTCBCurPtr); 

78 // 修改 优先 级 为 原来 的 

79 OSTCBCurPtr->Prio = p_ mutex->OwnerOriginalPrio; 
80 // 把 就 绪 优 先 级 位 映像 表 的 相应 位 置 1 

81 OS_PrioInsert (OSTCBCurPtr->Prio); 

82 // 重新 插入 就 绪 列 表 双 向 链表 的 最 后 

83 OS_RqyListInsertTail (OSTCBCurPtr); 

84 OSPrioCur = OSTCBCurPtr->Prio; 

85 } 

86 

87 // 等 待 列 表 上 的 第 一 个 任务 获得 mutex， 修 改 mutex 的 状态 

88 B teb = p pend list->HeadPtr->TCBPtr; 
89 p_mutex->OwnerTCBPtr = Bp toeby 

90 p_mutex->OwnerOriginalPrio = p tcb->Prio; 

91 p_mutex->OwnerNestingCtr = (OS NESTING CTR)1; 

92 

93 // 提交 任务 

94 OS_Post ( (OS PEND OBJ *) ((void *)p mutex) 

95 (OS_TCB *)p_tcb, 

96 (void *) Os 

97 (OS MSG SIZE )0, 

98 (CPU_TS )ts); 

99 

100 OS CRITICAL EXIT NO SCHED(); 

40 

102 // 是 否 要 进行 任务 调度 

103 if ((opt & OS OPT POST NO SCHED) 一 (OS OPT)0) { 
104 OSSched (); 

105 } 

106 

107 *p err = OS ERR NONE; 

108 } 





首先 ， 第 43~47 行 判断 提交 mutex 的 任务 是 不 是 拥有 mutex 的 任务 ， 如 果 不 是 ， 则 直接 返回 错误 。 这 点 不 像 信号 量 ， 多 值 信号 量 是 任何 任务 都 可 
以 提交 的 ， 而 mutex 公 拥有 mutex 的 任务 才 可 以 进行 提交 。 


其 次 ， 第 50~ 52 行 获取 提交 mutex 时 的 时 间 戳 ， 后 面 在 任务 调用 函数 OSM utexPend 获 取 mutex 的 时 候 返 
由 于 mutex 可 座 套 ， 旋 套 层 数 减 1 后 判断 mutex 是 否 可 用 ， 如 果 不 可 以 ， 则 返回 错误 。 


如 果 mutex 可 用 ， 则 判断 等 待 队 列 上 是 否 有 等 待 的 任务 ; 如 果 没 有 ， 就 清空 nutex 变 量 ， 然 后 返回 ， 如 果 等 待 列表 上 有 任务 就 要 先 让 获取 mutex 
的 任务 释放 mutex， 因 为 在 获取 mutex 的 时 候 可 能 已 经 为 了 防止 优先 级 反 转 而 修改 优先 级 ， 释 放 之 前 还 要 先 还 原 任务 的 优先 级 ， 并 且 重新 调整 任务 在 
就 绪 列表 中 的 位 置 。 任 务 在 就 绪 列 表 中 的 位 置 是 根据 优先 级 的 高 低 排列 的 。 


第 88~91 行 在 任务 即将 被 mutex 等 待 列表 上 优先 级 最 高 的 任务 获取 之 前 重 置 mutex 变 量 的 状态 。 然 后 调用 OSs_Post 函 数 让 任务 脱离 等 待 列表 ， 
入 就 绪 列 表 ， 根 据 输 入 参数 选项 判断 是 否 进 行 调度 。 


6.4 等 待 /获取 mutex 


函数 OSMutexPend 来 等 待 或 者 获取 mutex。 当 mutex 被 占用 的 时 候 就 等 待 ， 如 果 没有 等 待 就 直接 获取 ， 下 面 介绍 这 个 函数 的 用 法 和 源码 。 
1) p_mutex: 指向 mutex 变 量 的 指针 。 
2) timeout: 表示 任务 一 开始 获取 不 到 信号 量 等 待 的 节拍 数 。0 表 示 无 限期 地 等 待 。 
3) opt: 选项 可 分 为 以 下 两 种 。 
. OS_OPT_PEND_BLOCKING: 一 开始 获取 不 到 信号 量 就 阻塞 任务 ， 阻 塞 的 时 候 根 据 参 数 timeout 决 定 。 


" OS_OPT_PEND_NON_BLOCKING: 一 开始 获取 不 到 信号 量 就 退出 函数 ， 继 续 运 行 任务 。 





4) p_ts: 指向 等 待 的 信号 量 被 删除 ， 等 待 被 强制 停止 等待 超 时 等 情况 时 的 时 间 礁 的 指针 。 该 参数 输入 空 指针 ， 表 示 不 想 获 取 时 间 截 。 
5) p_err: 指向 返回 错误 类 型 的 指针 ， 主 要 有 以 下 几 种 类 型 (只 包含 部 分 ) 。 

"OS_ERR_MUTEX_OWNER: 信号 量 已 经 被 占用 。 

- OS_ERR_PEND_ABORT: 返回 的 时 候 不 是 因为 获得 mutex， 而 是 被 强制 解除 等 待 状态 。 


:. OS_ERR_PEND_ISR: 从 中 断 中 调用 等 待 函 数 。 





“OS_ERR_PEND_WOULD_BLOCK: 没有 获取 到 mutex， 输 入 的 参数 选项 是 OS_OPT_PEND_NON_BLOCKING 的 时 候 。 








. OS_ERR_SCHED_LOCKED: 调度 器 被 锁 住 了 。 


 OS_ERR_TIMEOUT: 等 待 mutex 超 时 了 。 


6.5 ”获取 mutexj 过 程 解 析 


6.5.1 ”开始 获取 mutex 


获取 mutex 的 函数 OSMutexPend 的 代码 见 代 码 清单 6-3。 


代码 清单 6-3 ”获取 mutex 函 数 OSMutexPend 

















1 void OSMutexPend (OS MUTEX *p mutex, 
2 OS_TICK timeout, 
3 Os_OPT opt， 

4 CPU TS *p ts, 

3 OS_ERR “Srr) 

6 { 

7 OS_PEND DATA pend data; 

8 OS TCB *p tcb; 

9 CPU SR ALLOC(); 

10 

11 

1] 

13 #ifdef OS SAFETY CRITICAL 

14 下 (P err == (OS ERR *)0) { 

4 OS_SAFETY ( CRITICAL ， EXCEPTION (); 
16 return; 

于 了 } 

18 #enqdif 

19 

20 #if OS CFG CALLED FROM ISR CHK EN > 0u 
2 if (OSIntNestingCtr > (OS NESTING CTR) 0) { 
22 *p err = OS ERR PEND ISR; 

23 return; 

24 } 

25 #endif 

26 

27 #if OS CFG ARG CHK EN > 0u 

28 Eb (p 1 mutex == (OS MUTEX *)0) { 


29 xp err = OS ERR OBJ PTR NULL; 











return; 
switch (opt) { 
Case OS_OPT PEND BLOCKING: 
case OS OPT PEND NON BLOCKING: 
break; 
default: 
*p err = OS ERR OPT INVALID; 
returns 
} 
#endif 
#if OS CFG OBJ TYPE CHK EN > Ou 





if (p mutex->Type != OS OBJ TYPE MUTEX) { 
*p err = OS ERR OBJ TYPE; 
return; 





} 


#engif 


if (p ts != (CPU TS *)0) { 
) 


) 
xp ts = (CPU TS )0; 
} 
CPU CRITICAL ENTER(); 
// 如 果 mutex 可 用 ， 则 直接 获取 mutex 
if (p mutex->OwnerNestingCtr == (OS NESTING CTR)0) { 
p_ mutex->OwnerTCBPtr OSTCBCurPtr; 
Pp_mutex->OwnerOriginalPrio OSTCBCUurPtr->Prio; 
p_ mutex->OwnerNestingCtr = (OS NESTING CTR)1; 
if (pts, != (CPU. TS *)0) 4{ 
*p_ts = p_ mutex->TS; 


} 

CPU_ CRITICAL EXIT(); 
* err 

eturn; 


OS_ERR NONE; 


} 
// 如 果 mutex 不 可 用 


// 如 果 获 取 mutex 的 任务 本 来 就 拥有 mutex， 则 谋 套 层 数 加 1 后 退出 
if (OSTCBCurPtr == p mutex->OwnerTCBPtr) { 
Pp_mutex->OwnerNestingCtr++; 
1if ‘(5:. ts: 1= {CPU TS: *)0) 4 
*p ts = p mutex->TS; 


} 

CPU CRITICAL EXIT(); 

*p err = OS ERR MUTEX OWNER; 
return; 





} 


// 是 否 要 进行 等 待 
if ((opt & OS OPT PEND NON BLOCKING) != (OS OPT)0) { 
// 不 等 待 ， 直 接 返回 错误 
CPU _ CRITICAL EXIT(); 
*p err = OS ERR PEND WOULD BLOCK; 
return; 
} else { 
// 后 面 要 将 任务 置 于 等 待 状态 ， 调 度 器 不 能 锁 住 
if (OSSchedLockNestingCtr > (OS_NESTING_CTR)0) { 
CPU CRITICAL EXIT(); 
*p err = OS ERR SCHED LOCKED; 
eleny 








} 


OS_CRITICAL ENTER CPU CRITICAL EXIT(); 
// 获取 拥有 mutex 的 任务 控制 块 指针 
p_ tcb = p mutex->OwnerTCBPtr; 
// 查看 准备 等 待 的 任务 的 优先 级 是 否 大 于 拥有 mutex 的 任务 的 优先 级 
if (p tcb->Prio > OSTCBCurPtr->Prio) { 
/* 提 升 优先 级 解决 优先 级 反 转 的 问题 ! 修改 优先 级 的 同时 还 要 





修改 其 在 各 种 列表 中 的 位 置 ， 因 为 很 多 列表 是 根据 优先 级 来 排序 的 */ 


Switch (p tcb->TaskState) { 

// 如 果 是 就 绪 状 态 ， 

Case OS TASK STATE RDY: 
OS_RdyListRemove (p tcb); 
Pp tcb->Prio = OSTCBCurPtr->Prio; 
OS_ PrioInsert (p tcb->Prio); 
OS RdyListIinsertHead (p tcb); 
break; 


// 延 时 和 挂 起 
case OS_ TASK STATE DLY: 

case OS TASK STATE DLY SUSPENDED: 
case OS_TASK STATE SUSPENDED: 


p_tcb->Prio = OSTCBCurPtr->Prio; 
break; 


// 各 种 等 待 状态 
Case OS_TASK STATE PEND: 
case OS_ TASK STATE PEND TIMEOUT: 
case OS_ TASK STATE PEND SUSPENDED: 
case OS TASK STATE PEND TIMEOUT SUSPENDED: 
OS_ PendListChangePrio(p tcb, 
OSTCBCurPtr->Prio); 











break; 


default: 
OS_CRITICAL EXIT(); 
*p err = OS ERR STATE INVALID; 
EEC 























131 } 

132 } 

133 

134 // 将 任务 脱离 就 绪 列 表 ， 插 入 等 待 列表 
135 OS_Pend (&pend data, 

136 (OS_PEND OBJ *) ((void *)p mutex), 
137 OS_TASK PEND ON MUTEX, 
138 timeout); 

139 

140 OS CRITICAL EXIT NO SCHED(); 

141 

142 // 任务 切换 

143 OSSched (); 

144 

145 // 任务 解除 等 待 状态 ， 重 新 获得 CPU 使 用 权 
146 

147 CPU CRITICAL ENTER(); 

148 /* 根 据 任 务 控 制 块 元 素 PendStatus 的 内 容 判 断 任务 是 如 何 解除 
149 等 待 状态 的 ， 并 返回 错误 */ 

150 switch (OSTCBCurPtr->PendStatus) { 
151 case OS_STATUS PEND OK: 

152 if ‘(pts ls ‘(CPU TS 0) 4 
153 *p ts = OSTCBCUurPtr->TS; 
154 } 

39 *p err = OS ERR NONE; 

156 break; 

157 

158 case OS_STATUS PEND ABORT: 

159 if (p ts.!= (CPU TS *)0) 1{ 
160 *p ts = OSTCBCurPtr->TS; 
161 } 

162 *p err = OS ERR PEND ABORT; 
163 break; 

164 

165 case OS_ STATUS PEND TIMEOUT: 

166 if. ‘(pts = (CPY TS *)0) { 
167 “pb. ts = (CPY TS. 70 

168 } 

169 *p err = OS ERR TIMEOUT; 

170 break; 

二 7 下 

172 case OS_STATUS PEND DEL: 

173 if (pts = "(CPU TS *)0) 1{ 
174 *p ts = QSTCBCurPtr->TS} 
75 } 

176 *p err = OS ERR OBJ DEL; 

7 break; 

178 

179 default: 

180 *p err = OS ERR STATUS INVALID; 
181 break; 

182 } 

183 CPU CRITICAL EXIT(); 

184 } 





第 56~66 行 用 于 检测 mutex 是 否 已 经 被 获取 ， 如 果 mutex 还 没有 被 获取 ， 那 么 很 简单 ， 任 务 直接 获取 到 mutex 后 返回 。 
第 70~78 行 ， 如 果 获 取 mutex 与 拥有 mutex 的 任务 是 同一 项 ， 那 么 谋 套 多 一 层 ， 并 将 元 素 OwnerNestingCtr 加 1。 


代码 流程 为 : 如 有 必要 ， 首 先 对 拥有 mutex 的 任务 的 优先 级 进行 调整 ， 然 后 将 等 待 mutex 的 任务 脱离 就 绪 列 表 ， 插 入 等 待 列表 ， 进 行 任务 调度 ， 
找到 就 绪 列表 中 优先 级 最 高 的 任务 继续 进行 调度 ， 直 到 任务 解除 等 待 状 态 才 回 到 当前 任务 的 OSM utexPend 函 数 处 。 


事实 上 ， 第 99 行 中 的 判断 “p_tcb->Prio>OSTCBCurPtr->Prio” 是 错误 的 ， 应 该 改 成 “p_tcb->Prio<OSTCBCurPtr->Prio”。 


6.6 删除 mutex 


用 函数 OSMutexDel 来 删除 mutex， 下 面 介 绍 该 函数 的 参数 和 源码 ( 见 代 码 清单 6-5) 。 
1) p_mutex: 指向 mutex 变 量 的 指针 。 

2) opt: 可 分 为 以 下 两 种 。 

: OS_OPT_DEL NO_PEND: 要 在 mutex 等 待 列 表 上 无 等 待 任务 的 时 候 才 可 以 删除 mutex。 
. OS_OPT_DEIL_ ALWAYS: 不 管 mutex 等 待 列表 上 是 否 有 等 待 的 任务 都 直接 删除 mutex。 


3) p_err: 指向 返回 错误 类 型 的 指针 ， 主 要 有 以 下 几 种 类 型 (只 包含 部 分 ) 。 


 OS_ERR_TASK _ WAITING: 参数 opt 是 OS_OPT_DEL NO_PEND， 但 是 mutex 等 待 列 表 上 有 等 待 的 任务 。 


“ OS_ERR_STATE_INVALID: 在 还 原 拥 有 mutex 任 务 优先 级 的 时 候 是 根据 任务 的 状态 进行 的 ， 如 果 检 测 到 任务 的 状态 超出 范围 ， 则 返回 这 个 错 


OS_ERR_DEL ISR: 从 中 断 中 调用 删除 函数 。 


代码 清单 6-5 ”获取 mutex 函 数 OSMutexPend 



































1 #if OS_ CFG MUTEX DEL EN > 0u 

2 OS OBJ QTY OSMutexDel (OS MUTEX *p mutex, 

3 OS_OPT opt, 

4 OS_ERR EE) 

与 二 

6 OS_OBJ QTY cnt; 

7 OS_OBJ QTY nbr tasks; 

8 OS PEND DATA *p pend data; 

9 OS PEND LIST *p pend list; 

10 OS_TCB xp tcb; 

OS_TCB *p 七 cb owner; 

12 CPU TS ts; 

13 CPU SR ALLOC () ; 

14 

15 

16 

17 #ifdef OS_ SAFETY CRITICAL 

1 if (p err == (OS ERR *)0) { 

19 OS5_SAFETY CRITICAL EXCEPTION(); 
20 return ((OS OBJ QTY)0); 
2 } 人 
22 #endif 
23 
24 #if OS CFG CALLED FROM ISR CHK EN > 0u 
25 if (OSIntNestingCtr > (OS NESTING CTR)0) { 
26 *p err = OS ERR DEL ISR; 加 
27 return ((OS OBJ QTY)0); 
28 } 
29 #endif 

30 

31 #if OS CFG ARG CHK EN > 0u 

J if (p mutex == (OS MUTEX *)0) { 

33 *p err = OS ERR OBJ PTR NULL; 

34 return ((OS OBJ QTY)0); 

35 } 

36 #engif 

37 

38 #if OS CFG OBJ TYPE CHK EN > 0u 

39 if (p mutex->Type != OS OBJ TYPE MUTEX) { 
40 *p err = OS ERR OBJ TYPE; 

41 return ((OS OBJ QTY)0); 

42 } ES 

43 #engdif 

44 

45 OS_CRITICAL ENTER(); 

46 p pend list = &p mutex->PendList; 

47 cht = p pend list->NbrEntries; 

48 nbr tasks = cnt; 

49 switch (opt) { 

50 // 如 果 只 在 没有 任务 等 待 mutex 的 情况 下 删除 

51 case OS_ OPT DEL NO PEND: 

52 // 判断 等 待 mutex 的 数量 个 数 

53 if (nbr tasks == (OS OBJ QTY)0) { 

54 #if OS CFG DBG EN > 0u 

55 // 从 调试 列表 的 双向 链表 中 删除 

56 OS MutexDbgListRemove (p mutex); 
57 #engif 

58 // mutex 个 数 减 1 

59 OSMutexQty-——; 

60 // mutex 变 量 

61 OS MutexClr (p mutex); 

62 OS_CRITICAL EXIT(); 

63 *p_ err = OS ERR NONE; 

64 } else { 

65 // 有 任务 在 等 待 mutex， 返 回 错误 

66 OS_CRITICAL EXIT(); 

67 *p err = OS ERR TASK WAITING; 

68 } 

69 break; 

70 

71 // 如 果 有 任务 等 待 mutex， 也 会 删除 mutex 

172 case OS _ OPT DEL ALWAYS: 

73 P_ tcb owner = p mutex->OwnerTCBPtr; 
74 /7 如 果 要 删除 ， 首 先 要 调整 优先 级 ， 调 整 的 过 程 跟 等 待 的 时 候 是 一 样 的 
73 if ((p tcb owner != (OS TCB *)0) && 
76 (P_tcb owner->Prio != p mutex->OwnerOriginalPrio)) { 
77 Switch (p tcb owner->TaskState) { 
78 case OS TASK STATE RDY: 

739 OS_ RdyListRemove (p tcb owner); 
80 P_tcb owner->Prio = p mutex->OwnerOriginalPrio; 
81 OS_PrioInsert (P tcb owner->Prio); 
82 OS RdyListIinsertTail (p tcb owner); 
83 break; 

84 


85 case OS_ TASK STATE DLY: 









































86 Case OS_TASK STATE SUSPENDED: 
87 Case OS _ TASK STATE DLY SUSPENDED: 
88 p_tcb owner->Prio = p mutex->OwnerOriginalPrio; 
89 break; 
90 
91 case OS_ TASK STATE PEND: 
92 case OS TASK STATE PEND TIMEOUT: 
93 Case OS_ TASK STATE PEND SUSPENDED: 
94 Case OS TASK STATE PEND TIMEOUT SUSPENDED: 
95 OS_PengdListChangePrio(p tcb owner， 
96 p_mutex->OwnerOriginalPrio); 
97 break; 
98 
99 default: 
100 OS_CRITICAL EXIT(); 
101 *p err = OS ERR STATE INVALID; 
102 return ((OS OBJ QTY)0); 
103 } 
104 } 
L105 
106 ts = OS TS GET(); 
107 // 将 等 竺 mutex 的 任务 一 个 个 地 从 等 待 列表 上 移 除 
108 while (cnt > 0Ou) { 
09 P pend data = p pend list->HeadPtr; 
0 p teb = p pend data->TCBPtr; 
1 OS_PendobjDel ( (OS_PEND OBJ *) ((void *)p mutex), 
2 p tcb, 
3 ts); 
114 Cnt—=» 
5 } 
6 #if OS CFG DBG EN > 0u 
OS_ MutexDbgListRemove (p mutex); 
8 #engif 
19 OSMutexQty--; 
120 OS MutexClr (p mutex); 
121 OS CRITICAL EXIT NO SCHED(); 
122 // 任务 调度 
123 OsSsched (); 
124 *p err = OS ERR NONE; 
125 break; 
26 
127 default: 
128 OS_CRITICAL EXIT(); 
129 *p err = OS ERR OPT INVALID; 
130 break; 
二 3 } 
132 return (nbr tasks); 
133 } 
134 #engif 








删除 mutex 与 删除 多 值 信号 量 两 个 过 程 类 似 。 只 是 删除 mutex 之 前 ， 如 果 有 任务 拥有 mutex， 则 还 要 还 原 优先 级 继承 之 前 的 信号 量 ， 具 体 的 过 程 
与 优先 级 继承 的 过 程 一 样 ， 都 是 改变 优先 级 ， 并 且 改 变 它们 在 各 种 列表 中 的 顺序 。 


6.7 ”强制 解除 等 待 mutex 


用 函数 OSMutexPendAbort 来 强制 解除 等 待 mutex， 下 面 介 绍 该 函数 的 使 用 和 源码 ( 见 代 码 清单 6-6) 。 


参数 主要 包含 以 下 几 个 。 
1) p_mutex: 指向 mutex 变 量 的 指针 。 
2) opt: 可 以 有 以 下 几 种 选项 。 


. OS_OPT_PEND_ABORT_1: 强制 解除 等 待 mutex 的 最 高 任务 。 





. OS_OPT_PEND_ABORT_ALL: 将 等 待 mutex 的 所 有 任务 都 强制 解除 等 待 状态 。 





3) p_err: 指向 返回 错误 类 型 的 指针 ， 主 要 有 以 下 几 种 类 型 。 
" OS_ERR_NONE: 没有 错误 。 
" OS_ERR_OBJ_PTR_NULL: 参数 p_mutex 是 一 个 空 指针 。 


` OS_ERR_OBJ_TYPE: 参数 p_mutex 指 向 的 内 核 变量 类 型 不 是 mutex。 


. OS_ERR_OPT_INVALID: 参数 opt 不 符合 要 求 。 


. OS_ERR_PEND_ABORT_ISR: 企图 在 中 断 中 强制 解除 等 待 mutex。 








. OS_ERR_PEND_ABORT_NONE: 没有 任务 在 等 待 。 





2. 返 回 值 


返回 值 用 于 解除 等 待 任务 状态 的 个 数 。 


代码 清单 6-6 ”强制 解除 等 待 mutex 函 数 OSMutexPendAbort 























1 #if OS CFG MUTEX PEND ABORT EN > 0u 
2 OS OBJ QTY OSMutexPendAbort (OS MUTEX *p mutex, 
3 OS_OPT opt, 
4 OS_ERR A SE 
5 1 
6 OS PEND LIST *p pend list; 
7 OS_TCB xpP_ tcb; 
8 CPU _ TS ts; 
9 OS_OBJ QTY nbr tasks; 
10 CPU SR ALLOC(); 
11 
J 
13 
14 #ifdef OS SAFETY CRITICAL 
2 if (P err == (OS PRR *)0) { 
16 OS_SAFETY CRITICAL ， EXCEPTION (); 
二 了 return ( (OS OBJ QTY) 0u); 
18 } 
19 #enqdif 
20 
21 #if OS CFG CALLED FROM ISR CHK EN > 0u 
22 if (OSIntNestingCtr > (OS NESTING CTR)Ou) { 
2 *p err = OS ERR PEND / ABORT . ISR; 
24 return ((OS OBJ _OTY) 0u); 
25 } 
26 #endif 
27 
28 #if OS CFG ARG CHK EN > 0u 
29 襟 丰 (P 1 mutex == (OS MUTEX *)0) { 
30 *p err = -08 ERR OBJ PTR NULL; 
31 return ((OS OBJ OTY) 0u); 
32 } 
33 switch (opt) { 
34 case OS OPT PEND ABORT 1: 
35 case OS OPT | PEND ) ABORT ALL: 
36 break; 
37 
38 defauilt: 
39 *p err = OS ERR OPT INVALID; 


return ((OS OBJ OTY) 0u); 
} 
#endif 


#if OS CFG OBJ TYPE CHK EN > Ou 
if (p mutex->Type != OS OBJ TYPE MUTEX) { 
*p err = OS ERR OBJ TYPE; 
return ((OS OBJ QTY) Ou); 





} 
#endif 


(心心 心心 心心 心心 心心 
Oo ~ 性 mm 有 品 








31 CPU CRITICAL ENTER(); 

52 p pend list = &p mutex->PengList; 

53 // 如 果 没 有 任务 在 等 待 mutex， 则 直接 返回 

54 if (p pend List->NbrEntries == (OS OBJ QTY)Ou) { 
55 CPU _ CRITICAL EXIT(); 

36 Berr 三 OS ERR PEND ABORT NONE; 
57 return ((OS OBJ OTY) 0u); 

58 } 

59 // 如 果 有 任务 在 等 待 mutex 

60 

61 OS CRITICAL ENTER CPU CRITICAL EXIT(); 
62 We tasks = Ou; 

63 = OS TS GET(); 

64 7 将 等 待 的 任务 从 等 竺 列表 中 移 除 


while (p pend list->NbrEntries > (OS OBJ QTY)Ou) { 
p tcb = p pend list->HeadPtr- >TCBPtr; 
OS_ PendAbort ( (OS_PEND OBJ *) ((void *)p mutex), 


p_tcb, 
ts); 
nbr tasks+t+; 
if (opt != OS OPT PEND ABORT ALL) { 
break; 


} 
} 
OS_CRITICAL EXIT NO SCHED(); 
// 根据 选项 看 是 否 进行 调度 


if ((opt & OS OPT POST NO SCHED) == (OS OPT)0u) { 
Ossched(); 





NN 
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} 


82 xp _ err = OS ERR NONE; 
83 return (nbr tasks); 
84 } 

85 #endif 


代码 清单 6-6 展 示 了 函数 OSMutexPendAbort 强 制 解除 等 待 mutex 的 过 程 。 整 个 过 程 跟 信号 量 解除 任务 等 待 状 态 基 本 一 样 ， 请 读者 自行 阅读 代 
码 。 


6.8 辟 结 


对 比 阅 读 所 有 函数 后 ， 我 们 发 现 ，mutex 跟 多 值 信和 号 量 的 主要 区 别 : @Omutex 操 作 的 时 候 需要 进行 优先 级 继承 ， 优 先 级 继承 不 仅 是 比较 优先 级 后 
要 对 其 进行 修改 ， 还 要 对 任务 所 在 的 就 绪 列表 或 者 等 待 列 表 进 行 修 改 。 因 为 这 些 表 是 根据 优先 级 进行 排列 的 ， 删 除 mutex 的 时 候 也 要 将 任务 的 优先 级 
还 原 回 来 。@mutex 只 能 被 一 个 任务 占用 。 


其 他 不 清楚 的 操作 请 参见 第 5 章 。 


第 / 章 ”消息 队列 


任务 之 间 仅 用 信号 量 进 行 “ 沟 通 ” 是 不 够 的 。 信 号 量 可 以 标志 事件 的 发 生 ， 却 无 法 传递 更 多 的 信息 。 在 需要 传递 更 多 数据 的 时 候 就 需要 用 到 消息 
队列 ， 比 如 当 将 采集 数据 和 处 理 数据 划分 为 两 个 任务 的 时 候 ， 在 采集 数据 的 任务 完成 采集 数据 后 ， 就 要 用 消息 队列 将 数据 传送 给 数据 处 理 任务 。 注 意 
阅读 时 不 要 把 消息 和 队列 混淆 在 一 起 ， 昌 然 平时 经 常 说 消息 队列 ， 但 是 消息 只 是 队列 中 的 一 员 ， 队 列 不 仅 包 括 消 息 部 分 ， 还 包括 管理 消息 部 分 。 





本 章 首先 介绍 消息 的 数据 结构 ， 接 着 介绍 容纳 消息 的 消息 池 的 数据 结构 及 其 创建 ， 最 后 介绍 队列 对 消息 的 管理 过 程 。 





7.1 实例 演示 





首先 ， 我 们 在 数据 采集 任务 中 通过 AD 获取 AD 值 ， 而 后 发 送 给 数据 处 理 任务 转化 为 电压 并 打印 到 串口 ， 如 图 7-1 所 示 。 主 要 代码 见 代 码 清单 7-1。 
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图 7-1 串口 打印 消息 队列 接收 到 的 电压 值 


这 里 有 两 个 能 有 些 同 学 会 想到 直接 用 全 局 变量 来 实现 两 个 任务 之 间 的 通信 ， 这 时 要 用 信和 号 量 将 它们 保护 起 来 ， 因 为 在 实时 操 
作 系 统 中 数据 的 读 / 写 往往 不 es 如 果 读 / 写 中 途 出 现任 务 切 换 数据 ， 就 可 能 会 出 错 。@ 数 据 获 取 和 数据 处 理 两 个 过 程 并 非 一 定 要 
划分 为 两 个 任务 ， 实 际 处 理 时 也 可 以 将 其 放 在 同一 个 任务 中 ， 获 取 数 据 后 接着 处 理 ， 省 去 了 消息 队列 的 使 用 。 但 当 数 据 的 获取 比较 急 且 不 能 丢失 的 时 
候 可 将 数据 获取 放 在 中 断 中 实现 ， 然 后 发 送 消息 给 数据 处 理 任务 即 可 。 代 码 清单 7-1 中 还 使 用 了 内 存 分 区 ， 详 情 请 见 后 面 的 章节 。 


代码 清单 7-1 等 待 消息 队列 代码 
1 while (1) 
2 { 
3 LED1 TOGGLE; 
4 // 等 待 消息 
5 P_ReceiveData=OSOPend ((0S Q *) &Queuey // 消息 变量 指针 
6 (OS_TICK ) 0， // 等 待 时 长 为 无 限 
7 (OS_OPT )OS_OPT PEND BLOCKING, 
8 (OS MSG SIZE *)&MsgSize, // 获取 消息 的 字 节 大 小 
9 (CPU_TS *) gPend Ts, // 获取 任务 发 送 时 的 时 间 鹤 
10 (OS_ERR *) &err); // 返回 错误 
Dl // 数据 处 理 
12 ADC_ConvertedValueLocal=(*p _ ReceiveData) *3.3/4096; 
13 // 放 回 内 存 块 
14 OSMemPut ((OS MEM *)é&MemOfAD, 
9 (void *)p ReceiveData, 
16 (OS ERR *)&err); 
17 
18 printf ("\r\nPC1 管 脚 的 电压 是 : %fV\r\n",ADC ConvertedValueLocal); 
19 3 





消息 的 数据 结构 OS_MSG 如 图 7-2 所 示 ， 主 要 包含 以 下 4 个 成 员 。 


OS MSO 
NextPtr 
NsgPtr 





图 7-2 ”消息 的 数据 结构 OS_MSG 示 意图 


"MsgPtt: 指向 消息 携带 的 数据 的 指针 。 


.MsgSize: 消息 的 大 小 。 





7.3 ”消息 池 


消息 在 未 被 用 到 的 时 候 与 单 向 链表 串联 在 一 起 (用 到 的 时 候 在 队列 中 也 串 成 一 个 单 向 链表 ) ， 每 次 要 存放 消 | 





应 “ 事 ” 和 “ 倒 ” 这 两 个 动作 ， 想 象 一 下 ， 未 被 使 用 的 消息 放 在 一 起 组 成 一 个 


“ 池 ”， 取 用 的 时 候 就 “ 


* NextPtr: 这 个 元 素 用 来 指向 下 一 个 消息 ， 队 列 中 所 有 的 消息 会 被 串 成 一 个 单 向 链表 。 


MsgTS: 在 消息 被 提交 的 时 候 保存 提交 时 的 时 间 稚 ， 在 消息 被 任务 获取 后 返回 给 任务 。 这 个 元 素 担任 了 一 个 中 转 的 角色 。 


息 的 时 候 就 拿 走 一 条 消息 放 到 队列 中 





去 (所 有 队列 都 可 以 从 消息 池 中 获取 消息 ) ， 任 务 从 队列 中 获取 消息 的 内 容 后 释放 消息 到 消息 池 ， 这 样 实现 了 消息 的 循环 利用 。“ 池 ” 字 对 
首 





息 


7/ 世 \ 


“ 池 ” 里 ， 是 不 是 很 形象 ? 


”一 条 消息 出 来 ， 用 完 就 “ 倒 ” 回 消 


在 HC/OS- 咱 开始 运行 之 前 ,调用 沙 数 OSInit 对 系统 进行 初始 化 ， 内 存 池 的 创建 和 初始 化 也 是 这 个 时 候 进 行 的 ， 如 代码 清单 7-2 所 示 。 


代码 清单 7-2 系统 初始 化 时 初始 化 内 存 池 


1 #if (OS MSG EN) > 0u 

2 OS MsgPoolInit (p err); 

3 if (*p err != OS ERR NONE) 
4{ 

3 return; 
6 } 

7 #engif 


在 uC/OS- 川 中 定义 一 个 数组 OSCfg_MsgPool[OS_ CFG_MSG POOL SIZE] 





， 因 为 在 使 用 消息 队列 的 时 候 存 取消 息 比较 频繁 ， 创 建 内 存 池 的 时 候 





系统 将 这 个 数据 的 各 个 元 素 串 成 单 向 链表 ， 组 成 消息 池 。 为 什么 这 里 是 单 向 链表 而 不 是 之 前 在 各 种 列表 中 看 到 的 双向 链表 ?因为 消息 并 不 需要 从 链表 
中 间 存 取 ， 只 需 在 链表 的 首尾 存 取 即 可 ， 使 用 单 向 链表 即 够 用 ， 使 用 双向 链表 反而 更 复杂 。 


消息 池 的 初始 化 函数 OS_MsgPoolinit 的 代码 如 代码 清单 7-3 所 示 。 


代码 清单 7-3 ”内 存 池 初 始 化 函数 OS_MsgPoolinit 


void OS MsgPoolInit (OS ERR *p err) 


#ifdef OS_SAFETY CRITICAL 

if (p err == (OS ERR *)0) { 
OS SAFETY CRITICAL EXCEPTION (); 
return; 





} 
#endif 


#if OS CFG ARG CHK EN > Ou 

if (OSCfg MsgPoolBasePtr == (OS MSG *)0) { 
*p err = OS ERR MSG POOL NULL PTR; 
return; 





} 

if (OSCfg MsgPoolSize = (OS MSG QTY)0) { 
*p_ err = OS ERR MSG POOL FMPTY; 
return; 





‘OOUOPOWNPOUOWO 和 OOOODP 





} 
#endif 


OS_ MsgPoolCreate (OSCfg MsgPoolBasePtr, 
OSCfg MsgPoolSize); 

OSMsgPool .NextPtr = OSCfg MsgPoolBasePtr; 

OSMsgPool .NbrFree = OSCfg MsgPoolSize; 

OSMsgPool .NbrUsed = (0S MSG QTY)O; 

* EE = OS ERR NONE; 
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OSMsgPool 是 一 个 全 局 变量 ， 用 来 管理 内 存 池 的 存 取 操作 ， 它 包含 以 下 三 个 元 素 。 


OSMsgPool 
NextPtr 


NbrUsed 





" NextPtt: 指向 第 一 个 可 用 的 消息 ， 即 消息 池 的 开始 。 


: NbrFree: 记录 消息 池 中 可 用 的 消息 个 数 。 


: NbrUsed: 记录 已 用 的 消息 个 数 。 








代码 清单 7-3 的 第 21~22 行 调用 函数 OS_MsgPoolCreate 将 消息 串 成 单 向 链表 ， 组 成 消息 池 。 第 23~25 行 初始 化 消息 池 管 理 变量 OSMsgPool， 
接 下 来 看 看 消息 池 是 怎么 被 创建 的 ， 如 代码 清单 7-4 所 示 。 





代码 清单 7-4 ”消息 池 的 创建 函数 OS_MsgPoolCreate 


1 voidq OS MsgPoolCreate (OS MSG xp msg, 
2 OS MSG QTY size) 
3 

4 OS_MSG *p msgl; 

5 OS_MSG *p msg2; 

6 OS MSG QTY i; 

7 OS MSG QTY loops; 

8 

9 

10 

I Pp msgl = p msg; 

2 Pp msg2 = P msg 

上 3 Pp_msg2++; 

14 loops = size - lu; 

15 for (i = Ou; i < loops; i++) { 

16 Pp msgl->NextPtr = p msg2; 

17 Pp msgl->MsgPtr = (void wos 

18 P_ msg1->MsgSize = (OS MSG SIZE)Ou; 
19 Pp msgl->MsgTS = (CPU TS ) Ou; 
20 Pp_msgl++; 

2] P_msg2++; 

22 } 

23 p_msgl->NextPtr = (OS MSG wj) 

24 p msgl->MsgPtr = (void 0 

25 Pp msgl->MsgSize = (OS MSG SIZE)Ou; 

26 Pp msgl->MsgIS = (CPU TS ) Ou; 

27 } 





创建 消息 池 的 过 程 就 是 依次 取出 每 个 消息 数组 元 素 ， 并 串 成 单 向 链表 ， 最 后 的 结果 如 图 7-3 所 示 。 


OSCfg MsgPool[0] > OSCfe MsgPool[1] OSCfe MsgPool[OS CFG MSG POOL SIZE-1] 









OSMsgPool OS MSG 


NextPtr NextPtr NextPtr 
Vesgsize VgSize 

















7.4 消息 队列 解析 


如 图 7-4 所 示 ， 消 息 队 列 的 数据 结构 OS_Q 除 了 等 待 队 列 必 需 的 OS_PEND_OBJ 类 型 元 素 外 ， 还 有 MsgQ 类 型 元 素 。MsgQ 包 含 如 下 几 个 元 素 ， 用 
来 管理 消息 队列 。 


NbrEntries: 记录 消息 队列 中 当前 的 消息 个 数 ， 每 提交 一 个 消息 ， 若 没有 任务 在 等 待 该 消息 队列 的 消息 ， 那 么 新 提交 的 消息 被 插入 此 消息 队列 
后 此 值 加 1。 


NbrEnttriesSize: 消息 队列 最 大 可 用 的 消息 个 数 ， 消 息 队 列 创 建 的 时 候 ， 其 中 一 个 参数 就 是 用 于 设 定 这 个 值 的 大 小 的 ，NPrEntties 的 大 小 不 能 超 


过 这 个 值 。 
: NbrEnteriesMax: 记录 队列 最 多 的 时 候 拥 有 的 消息 个 数 。 


* InPtr、OutPtr: 队列 中 的 消息 也 是 用 单 向 链表 串联 起 来 的 。 队 列 存 取 消息 有 两 种 方式 ， 一 种 是 如 图 7-5 所 示 的 FIFO 模 式 ， 即 先进 先 出 ， 这 时 消 
息 的 存 取 是 在 单 向 链表 的 两 端 ， 一 个 头 一 个 尾 ， 存 取 位 置 不 一 样 就 可 能 产生 这 两 个 输入 指针 和 输出 指针 。 一 种 是 如 图 7-6 所 示 的 LIFO 模 式 ， 即 后 进 先 
出 ， 这 时 消息 的 存 取 是 在 单 向 链表 的 一 端 ， 可 以 看 到 图 7-6 中 消息 队列 的 元 素 的 InPtr 处 的 箭头 变 成 虚线 并 指向 别处 ， 这 是 因为 仅 用 OutPtt 就 足够 指示 存 
取 的 位 置 。 当 队列 中 已 经 存在 比较 多 的 消息 没有 处 理 ， 又 有 个 紧急 的 消息 需要 马上 传送 到 其 他 任务 去 的 时 候 ， 就 可 以 在 发 布 消 息 的 时 候选 择 LIFO。 
如 果 有 任务 想 要 获取 消息 ， 就 会 直接 获取 到 这 个 消息 。 
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图 7-4 消息 队列 的 数据 结构 
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图 7-5 消息 队列 FIFO 模 式 
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消息 队列 全 


图 7-6 ”消息 队列 LIFO 模 式 


7.5 ”创建 消息 队列 


用 函数 OSQCreate 来 创建 消息 队列 ， 该 函数 的 使 用 和 源码 ( 见 代码 清单 7-5) 如 下 。 
参数 包含 以 下 几 个 。 

1) p_q: 指向 队列 变量 的 指针 。 

2) p_name: 指向 队列 名 字 字 符 串 的 指针 。 

3) max_qty: 队列 最 多 可 存放 的 消息 个 数 。 

4) p_err: 指向 返回 错误 类 型 的 指针 ， 可 分 为 以 下 两 种 。 


OS_ERR_CREATE_ISR: 企图 在 中 断 中 调用 创建 队列 函数 。 





" OS_ERR_Q_SIZE: 参数 max_qty 为 0。 


代码 清单 7-5 ”消息 队列 创建 函数 OSQCreate 























1 void OSQCreate (OS Q *p_q, 

2 CPU_CHAR *p_name, 
3 OS MSG OTY max qty, 
4 OS_ERR “SEr) 
5 

| 

有 CPU SR_ALLOC () 

8 

9 

0 

11 #ifdef OS _ SAFETY CRITICAL 

12 if (p err == (OS ERR *)0) { 

13 OS_SAFETY CRITICAL EXCEPTION(); 
14 returny 

1 } 

16 #engif 

17 

18 #ifdef OS SAFETY CRITICAL IEC61508 
19 if (OSSafetyCriticalStartFlag == DEF TRUE) { 
20 *p err = OS ERR ILLEGAL CREATE RUN TIME; 
21 return; 
22 } 
23 #endif 
24 
25 #if OS CFG CALLED FROM ISR CHK EN > 0u 
26 if (OSIntNestingCtr > (OS NESTING CTR) 0) { 
27 *p err = OS ERR CREATE ISR; 
28 return; 
29 } 

30 #engif 

31 

32 #if OS CFG ARG CHK EN > 0u 

38 if (pq== (0S © *)0) { 

34 *p err = OS ERR OBJ PTR NULL; 
35 return; 

36 } 

37 if (max qty == (OS MSG QTY)0) { 
38 *p err = OS ERR Q SIZE; 

39 return; 

40 } 

41 #engif 

42 

43 OS_CRITICAL ENTER(); 

44 p_9q->Type = OS OBJ TYPE Q; 

45 p_q->NamePtr = p _ name; 

46 // 初始 化 消息 队列 
47 OS MsgQInit (gp q->MsgQ, 
48 max qty); 
49 // 初始 化 等 待 列表 
50Q OS _ PendListInit (gp q->PendList); 
51 
52 #if OS CFG DBG EN > 0u 
53 // 插入 调试 列表 
54 OS QDbgListAdd (p q); 
55 #engif 
56 // 队列 个 数 加 1 
57 OSQOtLy++; 
58 
59 OS_CRITICAL EXIT(); 

60 *p err = OS ERR NONE; 

61 } 


如 代码 清单 7-5 所 示 ， 消 息 队 列 的 创建 过 程 也 是 进行 等 待 队列 的 初始 化 、 插 入 调试 队列 、 总 的 消息 队列 个 数 加 1 等 常规 操作 。 注 意 这 时 并 未 实际 从 
消息 池 中 获取 max_qty 消 息 给 队列 ， 而 是 等 到 要 提交 的 时 候 才 从 消息 池 中 获取 相应 消息 个 数 给 队列 。 


7.6 是 交 消 息 


提交 消息 的 参数 包含 以 下 几 个 。 
1) p_q: 指向 队列 变量 的 指针 。 


2) p_void: 指向 要 发 布 消息 的 内 容 的 指针 。 





3) msg _size: 消息 内 容 的 字 节 大 小 。 
4) opt: 提交 消息 时 的 选项 ， 包 含 以 下 几 种 类 型 。 

" OS_OPT_POST_ALL: 将 消息 发 布 给 所 有 等 待 消息 的 任务 。 
* OS_OPT_ POST_FIFO: 消息 提交 按照 先进 先 出 的 顺序 。 

: OS_OPT_ POST_LIFO: 消息 提交 按照 后 进 先 出 的 顺序 。 

" OS_OPT_ POST NO_SCHED: 提交 消息 后 不 再 进行 调度 。 
上 面 几 个 选项 的 不 同 功能 之 间 可 以 进行 相 与 。 

5) p_err: 指向 返回 错误 类 型 的 指针 ， 包 含 以 下 两 种 类 型 。 


. OS_ERR_MSG_POOL EMPTY: 消息 池 已 经 没有 可 用 的 消息 。 





: OS_ERR_Q_MAX: 队列 中 存放 消息 的 个 数 已 经 达到 最 大 的 容量 。 


7.7 ”提交 消息 过 程 解析 


在 信号 量 中 介绍 过 的 相似 操作 这 里 不 再 蓝 述 ， 相 关 代 码 可 在 给 出 的 例 程 中 查看 。 这 里 先 根据 图 7-7 中 的 标号 顺序 介绍 消息 传递 过 程 。 





(1) 消息 的 内 容 大 小 作为 参数 进行 传递 。 





图 7-7 中 的 (4) 表示 : 程序 过 程 检 测 是 否 有 任务 在 等 待 消息 ， 如 果 没有 任务 在 等 待 消息 ， 就 将 要 传递 内 容 的 指针 、 大 小 包装 在 消息 中 并 串 到 消息 
队列 中 ，OS_MsgQPut 实 现 了 这 个 过 程 。 






随 着 函数 的 调用 ， 消 息 的 内 容 
作为 参数 传递 下 来 。 


ed ea 





i 消息 的 内 容 放 到 消息 队列 中 去 ,| 
| ___ 等 后 面 任务 来 获取 。___1 


前 注 沽 洱 潍 国 关 丑 汝 送 计 外 


ne Tr 三 ec : | 
取出 消息 池 中 的 一 
| 通过 循环 调用 OS_Post 转 化 为 | 并 链接 到 消息 队列 中 去 


一 个 个 任务 的 被 提交 后 的 处 理 






-个 消息 








随 着 函数 的 调用 ， 消 息 的 内 容 
作为 参数 传递 下 来 。 








i a 










是 否 等 待 多 个 内 核对 象 


随 着 函数 的 调用 ， 消 息 的 内 容 
- 作为 参数 传递 下 来 。 
es 

(7) 
逐一 通过 比 对 当前 要 发 布 的 内 核对 象 (这 里 是 
消息 队列 ) 和 任务 等 待 多 个 内 核对 象 ， 然 后 标 








1 | 和 [将 等 待 多 个 内 核对 象 保存 到 OS_PEND DATA 1 
| 类 型 变量 的 元 素 RdyMsgPtr、RdyMsgSize 中 。 1 














记 RdyObjpt 元 素 为 当前 要 发 布 的 内 核对 象 “| 保存 提交 的 消息 队列 的 地 1 将 等 待 罗 不 内 核对 象 1 
大 小 ， 时 间 蕉 到 任务 控制 上 ! 保存 到 任务 块 中 。 _ | 














注 : 一 个 任务 可 能 







等 待 多 个 对 象 


将 任务 从 等 待 队列 中 
移 除 的 函数 


通过 循环 调用 OS_PendListRemovel 
转化 为 任务 ， 从 一 个 个 等 待 队列 中 移 除 


将 任务 从 一 个 等 待 队 列 中 
移 除 的 函数 


双向 链表 的 删除 节点 操作 


图 7-7 消息 队列 的 提交 过 程 


图 7-7 中 的 (7) 、 (8) 表示 : 如 果 有 任务 在 等 待 消息 ， 则 绕 过 消息 队列 ， 直 接 将 要 传递 内 容 的 指针 、 大 小 放 到 中 间 变 量 中 ， 接 着 让 等 待 消息 的 
任务 就 绪 ; 如 果 任 务 能 够 获得 CPU 使 用 权 ， 等 待 消息 的 任务 之 前 调用 的 等 待 函 数 就 会 将 传递 内 容 的 指针 、 大 小 返回 给 任务 。 这 里 提 到 的 中 间 变 量 可 以 
参看 图 7-7 右 边 的 两 个 虚 框 ， 分 为 两 种 情况 : 一 种 是 等 待 消息 的 任务 等 待 的 只 有 消息 ， 这 时 消息 内 容 的 指针 和 消息 字 节 大 小 会 放 到 等 待 的 任务 元 素 
MsgPtr、MsgSize 中 ， 参 见 代码 清单 5-6 第 64~67 行 ; 一 种 是 等 待 消息 的 任务 等 待 的 不 仅 是 消息 ， 而 且 等 待 的 是 多 个 内 核对 象 ， 任 务 在 等 待 的 时 候 会 
将 一 个 OS_ PEND_DATA 类 型 变量 插入 等 待 列表 中 。5.7.5 节 在 介绍 OS_ PEND_DATA 类 型 数据 结构 的 时 候 ， 已 经 提 及 其 中 有 两 个 元 素 RdyMsgPtr、 
RdyMsgSize 保 存 消息 内 容 的 指针 ， 以 及 消息 的 字 节 大 小 ， 参 见 代码 清单 5-7 第 18~19 行 。 


将 消息 插入 消息 队列 


因为 没有 任务 等 待 消息 ， 这 时 又 有 消息 被 提交 ， 所 以 只 能 放 到 队列 中 去 。 我 们 知道 ， 队 列 中 的 消息 个 数 是 “ 按 需 供给 ” ， 即 队列 中 如 果 多 放 一 个 
消息 ， 就 需要 到 消息 池 中 取出 一 个 消息 插入 队列 中 ， 用 完 后 再 放 回 消息 池 。 将 消息 插入 消息 队列 的 过 程 用 到 的 函数 是 OS_MsgQPut， 其 源码 参见 代 
码 清单 7-6。 


代码 清单 7-6 ”将 消息 插入 消息 队列 的 函数 OS_MsgQPut 


1 voidq OS MsgQPut (OS MSG Q *p msg Gy 








2 void “Dvolid; 

3 OS MSG SIZE msg size, 

4 OS_OPT opt, 

5 CPU_TS tS 

6 OS_ERR xD err) 

Y 1 

8 OS MSG *p msg; 

9 OS MSG *p msg in; 

10 

11 

12 

13 #ifdef OS SOE CRITICAL 

14 福生 (P err == (OS ERR *)0) { 

二 号 OS_SAFETY ( CRITICAL , EXCEPTION (); 

16 return; 

17 } 

18 #engif 

19 
20 // 如 果 当 前 消息 队列 中 消息 的 个 数 超过 消息 队列 限定 的 最 大 消息 个 数 
21 if (p msg q->NorEntries >= p msg q->NbrEntriesSize) { 
22 *p_ err = OS ERR Q MAX; 
23 return; 
24 } 
25 
26 // 消息 池 没 有 剩 下 的 消息 可 用 
27 if (OSMsgPool.NbrFree == (OS MSG QTY)0) { 
28 *p err = OS ERR MSG POOL EMPTY; 
29. return; 

30 } 

31 

32 // 从 消息 池 中 获取 消息 

33 P_msg = OSMsgPool .NextPptr; 
34 OSMsgPoo1 .NextPtr = p msg->NextPtr; // 指向 消息 池 下 一 个 可 用 的 消息 
35 OSMsgPool .NbrFree-—-; // 消息 池 可 用 的 消息 个 数 减 1 
36 OSMsgPool .NbrUsed++; // 消息 池 已 用 的 消息 个 数 加 1 
37 
38 // 将 消息 插入 消息 队列 
39 if (p msg q->NbrEntries == (OS MSG QTY)0) { 
40 P_msg_ gq->InPtr = p msg; 
41 PpP msg q->OutPtr = p msg; 
42 p_msg aq->NbrEntries = (OS MSG QTY)1; 
43 } else { 
44 if ((opt & OS OPT POST LIFO) == OS OPT POST FIFO) { 
45 p_ msg in = Pp msg gq->InPtr; 
46 p msg in->NextPtr = p msg; 
47 p_msg->NextPtr = (OS MSG *)0; 
48 Pp _ msg q->InPptr = p msg; 
49 } else { 
5 Pp _msg->NextPtr = Pp msg q->OutPptr; 
51 Pp _msg q->OutPtr = p msg; 
52 } 
53 Pp _msg q->NbrEntriest+t+; 
54 } 
与 本 
56 // 更 新 消息 队列 最 大 的 消息 个 数 
57 if (p msg q->NbrEntries > p msg q->NbrEntriesMax) { 
58 Pp msg q->NbrEntriesMax = p msg gq->NorEntries; 
59 } 

60 

61 p msg->MsgPtr = p void; 

62 P_msg->MsgSize = msg size; 

63 P_msg->MsgTS = Eas 

64 EL 和 = OS_ ERR NONE; 

65 .1} 











代码 清单 7-6 中 的 第 20~30 行 分 别 是 检测 消息 队列 是 否 已 经 达到 最 大 消息 个 数 和 消息 池 中 是 否 有 消息 可 用 。 第 32~36 行 是 从 消息 池 中 取出 一 个 消 
息 ， 由 于 是 单 向 链表 ， 操 作 相对 简单 了 很 多 ， 操 作 过 程 如 图 7-8 所 示 。 


第 40~42 行 是 队列 在 插入 第 一 个 消息 的 时 候 ， 消 息 队列 的 输出 指针 和 输入 指针 都 指向 第 一 个 插入 的 消息 ， 如 图 7-9 所 示 。 
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图 7-8 ”从 消息 池 中 取出 一 个 消息 
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图 7-9 ”消息 队列 插入 第 一 个 消息 














第 44~48 行 是 队列 中 已 经 有 消息 ， 并 且 是 先进 先 出 ， 操 作 顺 序 如 图 7-10 所 示 。 
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图 7-10 在 FIFO 消 息 队 列 中 插入 消息 


第 50、51 行 是 队列 中 已 经 有 消息 ， 并 且 是 后 进 先 出 ， 操 作 顺 序 如 图 7-11 所 示 。 
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消息 队列 个 


新 插入 的 消息 


图 7-11 在 LIFO 消 息 队 列 中 插入 消息 


7.8 ”等 待 消息 过 程 解析 


首先 查看 队列 中 有 没有 提交 消息 ， 如 果 有 ， 则 直接 获取 其 中 一 个 消息 的 内 容 后 返回 ; 如 果 没 有 已 经 提交 的 消息 ， 就 将 任务 挂 起 。 如 果 任 务 想 要 等 
待 消息 ， 就 释放 CPU 使 用 权 ， 进 行 任务 切换 后 ， 其 他 任务 占用 CPU。 直 到 其 他 任务 提交 了 消息 让 等 待 消息 的 任务 就 绪 ， 或 者 队列 被 删除 ， 任 务 等 待 被 
强制 停止 。 等 待 超 时 ，CPU 使 用 权重 新 被 等 待 消息 的 任务 获得 ， 任 务 从 中 间 变 量 中 获取 到 消息 的 内 容 、 消 息 大 小 、 提 交 的 时 间 惟 等 信息 即 完成 调用 。 


上 述 过 程 在 之 前 的 内 容 中 我 们 唯一 没有 讲解 过 的 就 是 怎么 从 队列 中 获取 消息 : 首先 取出 消息 的 内 容 ， 消 息 的 字 节 大 小 ;然后 调整 单 向 链表 、 更 新 
队列 ， 以 及 释放 消息 回 消息 池 。 这 里 不 进行 代码 分 析 ， 如 果 不 理解 ， 请 参见 前 面 将 消息 插入 队列 的 过 程 的 解析 以 及 图 示 。 





7.9 总 结 








本 章 非 常 紧凑 地 介绍 完了 消息 队列 ， 重 点 对 消息 队列 消息 池 的 概念 操作 、 队 列 的 数据 结构 和 操作 等 进行 了 解析 。 首 先 ， 用 “ 池 ”、“ 吾 ”、 
“ 倒 ” 等 词 来 给 大 家 解释 消息 池 ， 读 完 本 章 ， 应 该 知道 这 些 词 背 后 真正 的 意义 是 什么 。“ 池 ”就 是 单 向 链表 ，“ 避 ”就 是 将 消息 脱离 单 向 链 
表 ，“ 倒 ”就 是 将 消息 重新 插入 单 向 链表 中 。 接 着 讲解 了 消息 队列 的 数据 结构 。 消 息 队 列 的 数据 结构 跟 消息 池 有 点 类 似 ， 都 是 单 向 链表 ， 但 是 ， 由 于 
消息 队列 放 入 与 取出 消息 可 能 在 单 向 链表 的 两 端 (消息 队列 为 FIFO 的 时 候 ) ， 消 息 池 就 只 在 单 向 链表 的 一 端 存 取消 息 ， 消 息 队列 中 多 了 一 个 指针 。 
消息 的 传递 实际 上 只 是 传递 传送 内 容 的 指针 和 传送 内 容 的 字 节 大 小 。 这 在 使 用 消息 队列 时 就 要 注意 ， 获 取消 息 之 前 不 能 释放 放 在 消息 中 的 指针 内 容 ， 
比如 中 断定 义 一 个 局 部 变量 ， 然 后 将 其 地 址 放 在 消息 中 进行 传递 ， 中 断 退 出 之 前 消息 并 没有 被 其 他 任务 获取 ， 退 出 中 断 时 CPU 已 经 释放 了 中 断 中 的 这 
个 局 部 变量 ， 后 面 任务 获取 这 个 地 址 的 内 容 就 会 出 错 。 所 以 一 定 要 保证 在 获取 内 容 地 址 之 前 不 能 释放 内 容 这 个 内 存单 元 。 有 三 种 方式 可 以 避免 这 种 情 
况 。 

















1) 将 变量 定义 为 静态 变量 ， 即 在 其 前 面 加 上 static， 这 样 内 存单 元 就 不 会 被 释放 。 
2) 将 变量 定义 为 全 局 变量 。 


3) 将 要 传递 的 内 容 当做 指针 传递 出 去 。 比 如 地 址 0xabcdef 存 放 一 个 变量 的 值 为 5， 通 常 是 把 oxabcdef 这 个 地 址 传递 给 接收 消息 的 任务 ， 任 务 接 
收 到 这 个 消息 后 ， 再 取出 这 个 地 址 的 内 容 5。 但 是 ， 如 果 把 5 当做 “地 址 ”传递 给 任务 ， 那 么 接收 消息 的 任务 会 直接 将 这 个 “地 址 ”当做 内 容 去 处 理 。 
不 过 这 种 方法 不 能 传递 结构 体 等 比较 复杂 的 数据 结构 ， 因 为 消息 中 存放 地 址 的 变量 内 存 大 小 是 有 限 的 。 





第 8 章 ”事件 标志 


当 任 务 需要 同步 的 时 候 可 以 使 用 信号 量 。 首 先 任务 A 等 待 任务 B 发 送信 号 量 ， 任 务 B 在 两 任务 需要 同步 的 时 刻 发 送信 号 量 给 任务 A， 这 时 在 hC/OS- 
川内 核 的 管理 下 ，A、B 任 务 同时 继续 执行 。 如 果 同步 的 时 刻 需 要 任务 A 传送 数据 给 任务 B， 那 么 就 使 用 消息 队列 。 但 是 复杂 的 任务 同步 ， 比 如 多 个 事 
件 发 生 后 执行 其 他 事件 ,或 者 任务 D 需 要 任务 E 和 任务 F 分 别 采 集 完 两 种 数据 后 进行 数据 处 理 ， 用 信号 量 和 消息 队列 就 有 点 “强人 所 难 ”。 事 件 标志 的 
出 现 轻易 地 解决 了 这 些 复杂 的 同步 问题 。 有 时 还 要 结合 时 间 标志 、 信 号 量 和 消息 队列 一 起 使 用 。 








8.1 实例 演示 


图 8-1 中 定义 了 两 个 位 ， 分 别 是 按键 1 和 按键 2 的 标志 位 。 当 按键 被 按 下 的 时 候 ， 就 将 位 置 1， 按 键 弹 起 的 时 候 ， 将 相应 的 位 置 0。 调 用 函数 
OsFlagPost 即 可 完成 这 两 个 操作 ， 具 体 见 代码 清单 8-1。 
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图 8-1 串口 打印 消息 


代码 清单 8-1 按键 1 被 按 下 就 置 位 








1 // 查看 Keyl 是 否 被 按 下 
2 if (Key AccessState (&Keyl, &KeylState)==CHANGED) 
| 
4 if (KeylState==KEY DOWN) { 
5 PEintf ("AENn 设 置 KEY1 被 按 下 的 标志 ，LED1 亮 ") 
6 OSFlagPost ((OS FLAG GRP *)&FlagOfKey, 
学 (OS_FLAGS ) KEY1 DOWN, 
8 (OS_OPT )OS OPT _ POST_ FLAG SET, 
9 (OS_ERR *) &err); 
10 } else { 
11 // 清空 KEY1 被 按 下 的 标志 
12 OSFlagPost ((OS FLAG GRP *)&FlagOfKey, 
13 (OS_FLAGS ) KEY1 DOWN, 
14 (OS_OPT )OS_OPT POST FLAG CLR, 
水 过 (OS_ERR *) &gerr); 
16 } 
17 LED1 TOGGLE; 
18 } 


在 男 一 个 任务 中 ， 我 们 等 待 两 个 按键 被 按 下 之 后 就 点 亮 LED3， 接 着 等 待 两 个 按键 中 的 其 中 一 个 弹 起 ， 炸 灭 LED3。 循 环 执行 就 达到 按键 1 和 按键 2 
都 按 下 后 点 亮 LED3 的 效果 ， 其 他 情况 LED3 都 是 熄灭 的 ， 具 体 代码 见 代码 清单 8-2。 串 口 打 印 出 按键 按 下 的 信息 如 图 8-1 所 示 。 





代码 清单 8-2 创建 事件 标志 并 等 待 相应 的 位 被 置 1 


1 // 打印 提示 信息 














2 OSFlagCreate ((OS FLAG GRP *)&FlagOofKey, 

3 (CPU_CHAR *) "FlagOfKey", 

4 (OS_FLAGS ) 0， 

5 (OS ERR *) &err); 

6 while (1) 

7 { 

8 OSFlagPend ((OS FLAG GRP *) &FlagOfKey, 

:] (OS_FLAGS ) KEY1 DOWN |KEY2 DOWN, 
10 (OS _ TICK ) 0， 
4 和 1 (OS_OPT )OS OPT PEND FLAG SET ALL|OS OPT PEND BLOCKING, 
12 (CEU TS *)&Ts, 





上 所 (OS ERR *) gerr); 


14 printf ("NFNnKEYI 和 KEY2 都 被 按 下 ，LED3 也 亮 ") ; 
15 LED3 ON; 
16 


17 // 等 待 至 少 其 中 一 个 按键 松 开 
18 // 如 果 没 有 下 面 这 个 ， 在 同时 按 下 两 个 键 的 同时 就 会 多 次 执行 LED3_TOGGLE; 








9 OSFlagPend ((OS FLAG GRP *) &FlagOfKey, 

20 (OS_FLAGS ) KEY1 DOWN |KEY2 DOWN, 

21 (OS_TICK )0， 

22 (OS_OPT )OS_ OPT PEND FLAG CLR ANY|OS OPT PEND BLOCKING, 
23. (CPU_TS *) &TS7 

24 (OS_ERR *) &err); 

25 LED3 OFF; 

26 printf ("\r\nKEYl1 和 KEY2 至 少 一 个 松 开 了 "); 

27 BELHtf CO Ne Ni 

28 } 





8.2 ”事件 标志 组 数据 结构 解析 


事件 标志 组 的 数据 结构 体 类 型 OS FLAG_GRP 如 图 8-2 所 示 。OS_FLAG_GRP 相 对 其 他 的 事件 是 相当 简单 的 ， 除 了 Flags 元 素 外 ， 我 们 都 已 经 介绍 
过 。 元 素 Flags 记 录 了 所 有 位 被 设置 的 情况 ， 在 我 们 的 例 程 中 最 高 是 32 位 。 
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图 8-2 ”事件 标志 组 的 数据 结构 体 类 型 OS_FLAG_GRP 


8.3 ”创建 事件 标志 组 


事件 标志 组 的 创建 也 跟前 面 其 他 内 核对 象 差 不 多 ， 如 代码 清单 8-3 所 示 。 从 代码 清单 8-3 中 我 们 看 到 了 第 三 个 参数 设置 为 0%， 这 是 赋 给 事件 标志 组 
变量 的 元 素 Flags 的 值 ， 典 型 值 是 0， 表 示 所 有 的 位 都 没有 被 设置 过 。 当 然 ， 如 果 表 示 创 建 的 时 候 某 个 位 已 经 被 置 1， 则 可 以 将 相应 的 位 置 1 后 作为 参数 
输入 。 在 事件 标志 组 中 ， 若 某 事件 发 生 ， 则 相应 的 位 会 置 1， 表 示 已 经 发 生 。 在 上 面 的 例 程 8-1 中 一 开始 按键 都 设置 为 没有 按 下 。 


代码 清单 8-3 ”事件 标志 实例 演示 





1 OSFlagCreate ((OS FLAG GRP *)&FlagOofKey, 
2 (CEU_CHAR *) "FlagOofKey", 
3 (OS_FLAGS ) 0， 





4 (OS_ERR *) &err); 





事件 标志 组 创建 的 代码 非常 简单 ， 如 代码 清单 8-4 所 示 。 


代码 清单 8-4 ”事件 标志 组 创建 函数 OSFlagCreate 








voiqd OSFlagCreate (OS FLAG GRP *p grp, 
CPU CHAR *p_name, 
OS_FLAGS flags, 
OS_ERR *p_err) 


CPU_SR_ALLOC (); 


#ifdef OS SAFETY CRITICAL 





if ‘(perr == (OS ERR *)0) 1 
OS5_SAFETY CRITICAL EXCEPTION(); 
return; 

} 

#engdif 


PPPPpPpPp 
JoONARONPOLOOIAONARONPP 


// 不 运行 创建 内 核对 象 














18 #ifdef OS SAFETY _ CRITICAL IEC61508 

19 if (OSSafetyCriticalStartFlag == DEF TRUE) { 
20 *p err = OS ERR ILLEGAL CREATE RUN TIME; 
21 return; 

22 } 

23 #endif 

24 

25 // 是 否 在 中 断 中 调用 创建 函数 

26 #if OS CFG CALLED FROM ISR CHK EN > 0u 
27 if (OSIntNestingCtr > (OS NESTING CTR) 0) { 
28 *p err = OS ERR CREATE ISR; 
29 return; 

30 } 

31 #engif 

32 

33 // 参数 检测 

34 #if OS CFG ARG CHK EN > Ou 

35 if (p grp == (OS FLAG GRP *)0) { 
36 *p err = OS ERR OBJ PTR NULL; 
37 return; 

38 } 

39 #engif 

40 

41 OS_CRITICAL ENTER(); 

42 // 给 相应 的 元 素 赋值 

43 p_grp->Type = OS OBJ TYPE FLAG; 
44 P_grp->NamePtr = p_ name; 

45 p grp->Flags = flags; 

46 P_grp->TS = (CEU TS) 0; 

47 OS PendListInit (gp grp->PengList); 
48 


49 // 将 事件 标志 插入 调试 列表 
#if OS CFG DBG EN > 0u 

OS_ FlagDbgListAdd (p grp); 
#endif 





// 事件 标志 数量 +1 
OSFlagQty++; 


OS_CRITICAL EXIT(); 
*p_err = OS ERR NONE; 


On 
\ oo ~ 请 口 





8.4 ”等待 事件 标志 组 


OsFlagPend 函 数 用 于 将 任务 置 于 等 待 状态 ， 直 到 指定 的 位 根据 相应 的 选项 被 设置 后 才 解除 等 待 状态 。 


参数 主要 包含 以 下 几 个 。 
1) p_grp: 指向 事件 标志 组 变量 指针 。 
2) flags: 想 要 设置 的 位 。 


实际 上 ，KEY1_DOWN 和 KEY2_DOWN 的 定义 如 下 ， 它 们 分 别 表示 事件 标志 组 的 第 0 位 和 第 1 位 。 然 后 在 调用 函数 的 时 候 


EE 
只 需 


将 flags 设 置 为 


KEY1_DOWNIKEY2_DOWN， 因 为 等 待 的 这 两 个 位 将 被 设置 。 


1 #define KEY1 DOWN Ox01 
2 #define KEY2 DOWN 0x02 





3) opt: 这 个 参数 可 以 分 为 以 下 几 个 选项 。 


* OS_OPT_PEND_FLAG_CLR_ALL: 等 待 上 面 flags 选 定 的 位 都 被 清 0。 





* OS_OPT_PEND_FLAG_CLR_ANY: 等 待 上 面 flags 选 定 的 位 的 任意 一 位 被 清 0。 





" OS_OPT_PEND_FLAG_SET_ALL: 等 待 上 面 flags 选 定 的 位 都 被 置 1。 





* OS_OPT_PEND_FLAG_SET_ANY: 等 待 上 面 flags 选 定 的 位 的 任意 一 位 被 置 1。 











" OS_OPT_PEND_FLAG_CONSUME: 获取 到 任务 指定 的 位 都 被 设置 后 ， 再 对 这 些 位 进行 置 反 操作 ， 注 意 不 是 清 0。 这 个 选项 可 以 起 到 在 满足 条 
件 后 自动 复位 的 作用 。 上 面 4 个 选项 中 的 任意 一 个 可 以 和 这 个 选项 进行 与 运算 。 





.DOS_OPT_ PEND_NON_BLOCKING: 如 果 一 开始 判断 指定 位 的 设置 情况 不 满足 ， 则 不 继续 等 待 ， 直 接 退 出 函数 继续 运行 任务 。 





OS_OPT_PEND_BLOCKING: 如 果 一 开始 判断 指定 位 的 设置 情况 不 满足 ， 则 将 任务 置 于 等 待 状态 。 该 选项 属于 默认 选项 ， 参 数 输入 默认 选 定 
等 待 。 最 后 这 两 个 选项 之 一 可 以 和 前 面 的 任意 选项 进行 与 运算 。 


4) p_ts: 指向 等 待 的 信号 量 被 删除 ， 等 待 被 强制 停止 ， 等 待 超 时 等 情况 时 的 时 间 戳 的 指针 。 
5) p_err: 指向 返回 错误 类 型 的 指针 (只 包含 部 分 ) 。 

. OS_ERR_PEND_ABORT: 任务 在 等 待 相应 位 被 设置 的 时 候 被 强制 停止 了 等 待 。 

" OS_ERR_PEND_ISR: 在 中 断 中 企图 调用 OSFlagPend 函 数 。 


"OS_ERR_PEND_WOULD_BLOCK: 判断 指定 位 的 设置 情况 不 满足 ， 且 opt 选 项 当中 包括 OS_OPT_PEND_NON_BLOCKING。 








` OS_ERR_TIMEOUT: 等 待 超时 。 


2. 返 回 值 


返回 让 任务 脱离 等 待 状态 的 位 。 比 如 上 面 的 例子 中 ， 需 要 两 个 按键 都 按 下 任务 才能 脱离 等 待 状态 继续 运行 ， 那 么 最 后 按 下 的 那个 键 对 应 的 位 就 会 
回 。 


岗 


事件 标志 组 等 待 函 数 OSFlagPend 可 以 算是 本 书 中 最 长 的 函数 了 ， 因 为 等 待 之 前 的 处 理 比较 复杂 ， 在 上 面 函 数 使 用 介绍 中 选项 类 型 也 是 最 多 的 ， 
每 种 选项 都 要 进行 多 种 操作 。 不 过 只 要 熟悉 位 操作 ， 还 是 很 容易 明白 这 个 函数 的 。 具 体 的 代码 见 代码 清单 8-5。 


代码 清单 8-5 ”时 间 标 志 组 等 待 函数 OSFlagPend 














1 OS FLAGS OSFlagPend (OS_ FLAG GRP xp grp, 
2 OS_FLAGS flags, 
3 OS_TICK timeout, 
4 OS_OPT opt, 
5 CPU TS *p ts, 
6 OS_ERR 2 ee) 
了 二 
8 CPU BOOLEAN consume; 
9 OS_FLAGS flags rdy; 
10 OS_OPT mode; 
11 OS_PEND DATA pend data; 
12 CPU SR ALLOC(); 
13 
14 
15 
16 #ifdef OS _ SAFETY CRITICAL 
.7 if (p err == (OS ERR *)0) { 
18 O5_SAFETY CRITICAL EXCEPTION (); 
19 return ((OS FLAGS)0); 
20 } 
21 #engdif 
22 
23 #if OS CFG CALLED FROM ISR CHK EN > 0u 
24 if (OSIntNestingCtr > (OS NESTING CTR) 0) { 
25 *p err = OS ERR PEND ISR; 











return ((OS FLAGS)0) 7 








} 
#endif 
#if OS CFG ARG CHK EN > 0u 
if (pb grp = (OS FLAG GRP *)0) { 
*p err = OS ERR OBJ PTR NULL; 
return ((OS FLAGS)0); 
} 
#endif 
#if OS CFG OBJ TYPE CHK EN > 0u 
if (p grp->Type != OS OBJ TYPE FLAG) { 
*p err = OS ERR OBJ TYPE; 
return ((OS FLAGS)0); 
} 
#endif 
// 获取 到 相应 的 位 被 设置 好 后 ， 判 断 是 否 将 它们 重新 置 反 的 标志 
if ((opt & OS OPT PEND FLAG CONSUME) != (OS OPT)0) { 
consume = DEF TRUE; 
} else { 
consume = DEF FALSE; 
} 
// 如 果 时 间 稚 变量 为 空 指针 ， 则 将 其 指向 的 内 容 置 0 后 不 再 设置 时 间 蕉 变量 
if (pts 4= (CPY TS *)0) 4 
*p ts = (CPU TS)0; 
} 
// 获取 位 要 设置 的 情况 的 选项 ， 放 在 变量 moqe 中 
mode = opt & OS OPT PEND FLAG MASK; 
CPU_CRITICAL ENTER(); 
Switch (mogde) { 
// 指定 的 位 都 置 1 
case OS OPT PEND FLAG SET ALL: 
// 获取 位 设置 的 情况 ( 放 在 时 间 标志 组 变量 的 元 素 Flags) 跟 我 们 指定 的 位 的 设置 情况 (输入 参 











数 flags) 进行 比较 


flags rdy = (OS FLAGS) (p grp->Flags & flags); 
// 对 托 后 如 果 符 合 我 们 要 设置 的 情况 
if (flags rdy == flags) { 
// 根据 选项 看 是 否 要 将 相应 的 位 置 反 
if (consume == DEF TRUE) { 
// 相应 位 置 反 
p_grp->Flags &= ~flags rdy; 


} 
// 保存 那些 让 任务 就 绪 的 位 在 任务 控制 块 的 FlagsRdy 元 素 中 
OSTCBCurPtr->FlagsRdy = flags rdy; 
if (BD: ts: Ie ‘(CPU _ TS *)yO) 4 
*p ts = pgrp->18» 


} 

CPU CRITICAL EXIT(); 
*p err = OS ERR NONE; 
return (flags rdy); 

] else { // 如 果 要 获取 的 位 的 设置 情况 不 符合 
// 是 否 进行 等 待 
if ((opt & OS OPT PEND NON BLOCKING) != (OS OPT)0) 

// 不 想 等 得 ， 直 接 退 出 

CPU CRITICAL EXIT(); 

*p err = OS ERR PEND WOULD BLOCK; 

return ((OS FLAGS)0); 

} else { 

// 要 进行 等 待 首先 判断 调度 器 是 否 被 锁 住 

if (OSSchedLockNestingCtr > (OS NESTING CTR) 0) 
CPU _ CRITICAL EXIT () 7 
*p err = OS ERR SCHED LOCKED; 
return ((OS FLAGS)0); 














} 


// 调度 器 没有 被 锁 住 ， 将 任务 置 于 等 待 状态 


OS CRITICAL ENTER CPU CRITICAL EXIT(); 
OS_FlagBlock (gpend data, 
p_grp, 
flags, 
opt, 
timeout); 
OS CRITICAL EXIT NO SCHED(); 








} 


break; 





Case OS OPT PEND FLAG SET ANY: 





flags rdy = (OS FLAGS) (p grp->Flags & flags); 
if (flags rdy != (OS FLAGS)0) { 
if (consume == DEF TRUE) { 
p_grp->Flags &= ~flags rdy; 
} 
OSTCBCurPtr->FlagsRdy = flags rdy; 
if:. (pp: ts: 1=: (CPU TS 六 的 这 
*p te pIrp=>T8; 
} 
CPU CRITICAL EXIT(); 
*p_err = OS_ERR NONE; 
return (flags rdy); 
} else 1 
if ((opt & OS OPT PEND NON BLOCKING) != (OS OPT)0) 
CPU_CRITICAL EXIT(); 
*p err = OS ERR PEND WOULD BLOCK; 
return ((OS FLAGS)0); 
} else { 
if (OSSchedLockNestingCtr > (OS_ NESTING CTR)0) 








{ 


{ 











CPU _ CRITICAL EXIT(); 
*p err = 
return ((OS FLAGS)0); 








} 


OS ERR SCHED LOCKED; 


OS_ CRITICAL ENTER CPU CRITICAL EXIT(); 





OS_ FlagBlock(&pend data, 
p_grp, 
flags, 
opt, 
timeout); 
OS CRITICAL EXIT NO SCHED(); 





} 


break; 


#if OS CFG FLAG MODE CLR EN > 0u 
Case OS OPT PEND FLAG CLR ALL: 
flags rdy = (OS FLAGS) (~p_ grp->Flags & 
if (flags rdy == flags) { 
if (consume DEF TRUE) { 
p_grp->Flags |= flags rdy; 











OSTCBCurPtr->FlagsRdy = flags rdy; 


if (pts 1!= (CPU TS *)0) { 
wo ts = Pqrp->ST0 
PU CRITICAL EXIT(); 
NONE; 


eturn (flags rdy); 


} 
C 
*p_err = OS_ERR 
工 
Se { 





CPU CRITICAL EXIT () ; 





if ((opt & OS OPT PEND NON BLOCKING) 


Liaygs}sy 


!= (OS_OPT)0) 


*p err = OS ERR PEND WOULD BLOCK; 
return ((OS FLAGS)0); 
} else { 


if (OSSchedLockNestingCtr > (OS_ NESTING CTR)0) 





CPU_ CRITICAL EXIT(); 
*p err = OS ERR SCHED LOCKI 
return ((OS FLAGS)0); 








} 


ED; 


OS_ CRITICAL ENTER CPU CRITICAL EXIT(); 





OS_ FlagBlock(&pend data, 
p_grp, 
flags, 
opt, 
timeout); 

OS CRITICAL EXIT NO SCHED(); 





} 


break; 








case OS OPT PEND FLAG CLR ANY: 
flags rdy = (OS FLAGS) (~p_grp->Flags & 
if (flags rdy != (OS FIAGS)0) { 
if (consume == DEF TRUE) { 
p_grp->Flags |= flags rdy; 





OSTCBCurPtr->FlagsRdy = flags rdy; 
if (p ts != (CPU TS *)0) { 
wp ts 二 gp=>TS) 


} 

CPU CRITICAL EXIT(); 

A OEE = OS ERR NONE; 
return (flags rdy); 

se { 





CPU_CRITICAL EXIT(); 





if ((opt & OS OPT PEND NON BLOCKING) 


flags)? 


!=" (O08: OPT)O) 


*p err = OS ERR PEND WOULD BLOCK; 
return ((OS FLAGS)0); 
} else { 


if (OSSchedLockNestingCtr > (OS_ NESTING CTR)0) 





CPU_ CRITICAL EXIT(); 
*p err = OS ERR SCHED LOCKI 
return ((OS FLAGS)0); 








} 


ED; 


OS_ CRITICAL ENTER CPU CRITICAL EXIT(); 





OS_FlagBlock (&pend data, 
p_grp, 
flags, 
opt, 
timeout); 
OS CRITICAL EXIT NO SCHED(); 





} 
break; 
#endif 


default: 
CPU_ CRITICAL EXIT(); 
*p err = OS ERR OPT INVALID; 
return ((OS FLAGS)0); 


} 
// 任务 调度 
Ossched (); 
// 任务 重新 就 绪 后 才 会 进行 下 面 的 程序 


CPU_CRITICAL ENTER(); 
// 检查 任务 是 因为 什么 情况 解除 等 待 状态 的 





{ 


{ 


{ 


{ 


228 Switch (OSTCBCurPtr->PendStatus) { 

































































229 case OS_STATUS PEND OK: 

230 i (pts es (CPU TS: #)0) 4 

231 *p ts = OSTCBCurPtr->TS; 
232 } 

233 *p err = OS ERR NONE; 

234 break; 

235 

236 case OS_ STATUS PEND ABORT: 

237 if (pts = (CPU TS *)0) 4{ 

238 *p ts = OSTCBCurPtr->TS; 
239 } 

240 CPU_ CRITICAL EXIT (); 

241 *p err = OS ERR PEND ABORT; 
242 return ((OS FLAGS)0); 

243 

244 case OS_ STATUS PEND TIMEOUT: 

245 Ef ‘(pp ts J!=: (CPY TS: *) 0 { 

246 *p ts = (CPU TS )0; 

247 } 

248 CPU_ CRITICAL EXIT (); 

249 *p err = OS ERR TIMEOUT; 

250 return ((OS FLAGS)0); 

51 

252 case OS_STATUS PEND DEL: 

253 if (pts := (CPU TS *)D) { 

254 *p ts = OSTCBCurPtr->TS; 
258 } 

256 CPU_ CRITICAL EXIT(); 

257 *p err = OS ERR OBJ DEL; 

258 return ((OS FLAGS)0); 

259 

260 default: 

261 CPU_ CRITICAL EXIT(); 

262 *p err = OS ERR STATUS INVALID; 
263 return ((OS FLAGS)0); 

264 } 

265 

266 // 任务 在 Post 时 间 标 志 组 的 时 候 已 经 将 它们 放 在 任务 控制 块 的 元 素 FlagsRdy 中 了 
267 flags rdy = OSTCBCurPtr->FlagsRdy; 
268 // 置 反 相应 的 位 

269 if (consume == DEF TRUE) { 

270 switch (mode) { 

:7 case OS OPT PEND FLAG SET ALL: 
2:12 case OS OPT PEND FLAG SET ANY: 
2:73 p_grp->Flags &= ~flags rdy; 
274 break; 

275 

276 #if OS CFG FLAG MODE CLR EN > 0u 

277 case OS OPT PEND FLAG CLR ALL: 
2718 case OS OPT PEND FLAG CLR ANY: 
279 p_grp->Flags |= flags rdy; 
280 break; 

281 #endif 

282 default: 

283 CPU CRITICAL EXIT(); 

284 *p err = OS ERR OPT INVALID; 
285 return ((OS FLAGS)0); 

286 } 

287 } 

288 CPU CRITICAL FEXIT(); 

289 *p err = OS ERR NONE; 

290 return (flags rdy); 

291 } 


代码 清单 8-5 的 45~49 行 取出 选项 OS OPT_PEND_FLAG_CONSUME 这 个 位 进行 判断 ， 以 便 后 面 决定 是 否 在 任务 指定 的 位 都 被 设置 好 后 ， 对 
位 全 部 进行 置 反 操作 。 取 出 的 操作 是 用 输入 的 参数 opt 跟 OS_OPT_PEND_FLAG_CONSUME 位 进行 与 操作 ， 很 容易 知道 opt 中 的 
OS_OPT_PEND _ FLAG_ CONSUME 位 是 0 还 是 1。 同 理 ， 在 57 行 ， 选 项 和 OS OPT_PEND_FLAG_MASK 进 行 与 操作 取出 


OS_OPT_PEND_FLAG_MASK 的 这 些 位 。 各 个 位 的 宏 定义 如 代码 清单 8-6 所 示 。 


代码 清单 8-6 ”等待 时 间 标 志 组 选项 宏 定义 


#define OS OPT PEND FLAG MASK 
#define OS OPT PEND FLAG CLR ALL 
#define OS OPT PEND FLAG CLR ANY 
#define OS OPT PEND FLAG SET ALL 
#define OS OPT PEND FLAG SET ANY 
#define OS OPT PEND FLAG CONSUME 

















OOPRODP 

















(OS_OPT 
(OS_OPT 
(OS_OPT 
(OS_OPT 
(OS_OPT 
(OS_OPT 


0x000Fuy) 
Ox0001u) 
Ox0002u) 
0x0004u) 
0x0008u) 
0x0100u) 


AN 


这 


些 


从 上 面 可 以 知道 取出 低 4 位 是 为 了 排除 OS_OPT_PEND FLAG CONSUME、OS OPT PEND NON_BLOCKING、OS OPT PEND BLOCKING 这 








些 选项 的 干扰 。 正 常情 况 下 ， 相 与 的 结果 mode 低 4 位 中 有 有 上 且 只 有 一 位 被 置 1。 通 过 判断 mode 就 可 以 知道 任务 是 要 将 选 定 的 位 进行 哪些 操作 : 全 部 清 





0， 任 意 一 位 清 0， 全 部 置 1， 还 是 任意 一 位 置 1。 从 宏 定 义 选项 就 可 以 知道 ， 低 4 位 每 位 对 应 的 就 是 这 些 操作 选项 之 一 。 


接 下 来 查看 mode 以 确定 是 哪 种 操作 ， 对 应 每 种 操作 的 代码 都 是 类 似 的 。 将 事件 标志 组 位 被 设置 的 情况 跟 任务 要 设置 的 位 和 设置 的 选项 进行 比 
较 ， 如 果 一 致 ， 那 么 证 明 符 合 我 们 要 设置 的 情况 。 如 有 必要 将 之 前 设置 好 的 位 进行 置 反 操 作 ， 则 最 后 返回 时 间 惟 和 让 任务 脱离 等 待 列 表 的 那些 位 ， 放 


在 任务 控制 块 的 FlagsRdy 元 素 当中 。 如 果 对 比 结果 不 一 致 ， 那 么 就 需要 将 任务 置 于 等 待 状态 。 其 实 对 比 信号 量 时 ， 主 要 是 判断 的 过 程 还 有 其 他 一 些小 
细节 不 一 样 。 等 待 信号 量 的 时 候 ， 我 们 也 是 先 看 看 信号 量 是 否 可 用 ， 如 果 可 用 就 返回 ， 不 可 用 就 将 任务 置 于 等 待 的 状态 ， 任 务 释放 CPU 使 用 权 。 这 里 
主要 讲解 代码 是 怎么 判断 事件 标志 组 已 经 设置 的 位 的 情况 是 不 是 跟 我 们 想 要 设置 的 情况 是 一 样 的 。 











61~105 行 任务 等 待 的 是 将 所 有 选 定 的 位 进行 全 部 置 1， 首 先 将 要 设置 的 位 跟 目 前 已 设置 的 位 相 与 ， 运 算 的 结果 跟 要 设置 的 位 (全 部 置 1) 进行 比 
较 ， 如 果 相 等 则 说 明 要 设置 的 位 中 全 部 都 是 1。 若 存在 其 中 一 个 位 没有 被 设置 为 1， 那 么 相 与 的 结果 中 那 位 就 是 0。 而 且 相 与 的 结果 刚好 就 是 让 任务 脱 
离 等 待 状态 的 那些 位 ， 返 回 此 值 即 可 。 其 他 选项 判断 的 过 程 在 这 就 不 再 进行 讲解 ， 下 面 讲解 如 果 已 设置 的 位 的 情况 跟 我 们 想 要 设置 的 不 同 的 时 候 将 任 
务 置 于 等 待 状态 的 操作 。 


代码 清单 8-7 中 Os_FlagBlock 函 数 的 功能 ， 是 在 目前 标志 位 设置 情况 不 同 于 任务 所 等 待 的 设置 的 情况 时 将 任务 置 于 等 待 状态 。 任 务 控制 块 的 
FlagsPend 元 素 记录 了 哪些 位 需要 被 设置 ， 比 如 我 们 的 例 程 中 这 个 值 肯定 是 KEY1_.DOWN|IKEY2_DOWN ， 即 事件 标志 组 的 第 0 位 和 第 1 位 。FlagOpt 
元 素 保 存 了 设置 的 选项 ， 在 调用 函数 OSFlagPend 的 时 候 就 有 相应 的 选项 供 选择 。FlagsRdy 元 素 是 放置 让 任务 就 绪 的 那些 标志 位 的 。hC/OS- 员 提供 
了 一 个 函数 OSFlagPendGetFlagsRdy 来 获取 这 个 元 素 的 内 容 。 


代码 清单 8-7 ”将 任务 置 于 等 待 状 态 的 函数 OS_FlagBlock 








1 voidq OS FlagBlock (OS PEND DATA *p pend data, 
2 OS FLAG GRP  *p grp, 

本 OS_FLAGS flags, 

4 OS_OPT opt, 

与 OS_TICK timeout) 
6 { 

这 OSTCBCurPtr->FlagsPend = flags; 

8 OSTCBCurPtr->FlagsOpt = opt; 

9 OSTCBCurPtr->FlagsRdy = (OS FLAGS)0; 
10 

IE OS_Pend (p_pend data, 

12 (OS_PEND OBJ *) ((void *)p grp), 
13 OS_TASK PEND ON FLAG, 

14 timeout); 

5: 站 


8.5 ”提交 事件 标志 组 


事件 标志 组 的 提交 过 程 主要 包括 : 根据 选项 设置 位 ， 更 新 元 素 Flags; 检查 所 有 等 待 特定 位 被 设置 的 任务 跟 当 前 事件 标志 组 已 经 设置 的 位 情况 是 
否 一 致 ， 如 果 一 致 ， 让 任务 解除 等 待 状态 。 这 些 操作 实现 代码 主要 在 代码 清单 8-8 中 的 函数 ODS_FlagPost 实 现 。 


从 功能 实现 上 来 讲 ， 函 数 OSFlagPost 对 于 事件 标志 组 的 提交 操作 等 同 于 置 标志 位 。 人 处 理 上 还 要 靠 其 背后 的 等 待 列表 。 
参数 

1) p_grp: 指向 事件 标志 组 变量 的 指针 。 

2) flags: 想 要 设置 的 标志 位 。 

3) opt: 置 位 选项 ， 可 以 是 以 下 两 个 选项 之 一 。 


" OS_OPT POST_FLAG_SET: 参数 flags 选 定 的 标志 位 全 部 置 1。 





OS_OPT_POST_FLAG_CLR: 参数 flags 选 定 的 标志 位 全 部 清 0。 





4) p_err: 指向 返回 错误 类 型 的 指针 ， 主 要 有 以 下 几 种 类 型 (只 包含 部 分 ) 。 
" OS_ERR_OBJ_PTR_NULL: 参数 p_grp 是 空 指 针 。 
" OS_ERR_OBJ_ TYPE: 参数 p_grp 指 向 的 变量 类 型 不 是 事件 标志 组 。 
" OS_ERR_OPT_INVALID: 参数 opt 不 是 指定 的 选项 之 一 。 


代码 清单 8-8 ”信和 号 量 提交 的 主要 函数 OS_FlagPost 


2 
3 
4 
3 
6 
7 
8 


9 
10 
IE 
12 
13 
14 
15 
16 
于 了 
18 
19 
20 
21 
22 
23 
24 
25 
26 
27 
28 
29 
30 
31 
32 
33 
34 
39 
36 
37 
38 
39 
40 
41 
42 
43 
44 
45 
46 
47 
48 
49 
50 
51 
52 
33 
54 
53 
56 
57 
58 
59 
60 
61 
62 
63 
64 
65 
66 
67 
68 
69 
70 
2 
72 
73 
74 
75 
76 
77 
78 
79 
80 
81 
82 
83 
84 
85 
86 
87 
88 
89 
90 
91 
92 
93 
94 
95 
96 
97 
98 
99 
100 








OS FLAGS OS FlagPost (OS FLAG GRP *p grp, 
OS_FLAGS flags, 
OS_OPT opt, 
CPU_TS ts; 
OS_ERR *p rr) 
{ 
OS_FLAGS flags cur; 
OS_FLAGS flags rdy; 
OS_OPT mode; 





OS PEND DATA  *p pend data; 

OS PEND DATA  *p pend data next; 
OS PEND LIST *p pend list; 
OS_TCB xp tcb; 

CPU SR ALLOC(); 


CPU CRITICAL ENTER(); 
// 很 据 选 项 设置 Flags 元 素 中 的 标志 位 








switch (opt) { 

case OS_OPT POST FLAG SET: 

case OS OPT POST FLAG SET | OS OPT POST NO SCHED: 
P_grp->Flags |= flags; 
break; 


case OS OPT POST FLAG CLR: 








case OS OPT POST FLAG CLR | OS OPT POST NO SCHED: 





Pp_grp->Flags &= ~flags; 
break; 


default: 
CPU _ CRITICAL EXIT(); 
*p err = OS ERR OPT INVALID; 
return ((OS FLAGS)0); 


} 

// 保存 时 间 鹤 

Pp_grp->TS = ts? 

// 找 出 管理 等 待 列表 的 元 素 PendList 

p pend list = &p grp->PendList; 

鲁 (p_pengd list->NbrEntries == 0u) { 
CPU _ CRITICAL EXIT(); 
xpP err = O8 ] ERR NONE; 
return (oa >Flags); 








} 


// 检查 所 有 等 待 列 表 上 的 任务 ， 看 目前 设置 的 标志 位 的 情 


OS CRITICAL ENTER CPU _ CRITICAL EXIT(); 
p pend data = p pend list->HeadPtr; 
p_tcb = p_ pend data->TCBPtr; 
while (p tcb != (OS TCB *)0) { 








况 是 否 符合 这 些 任 务 的 等 待 情况 


Pp pend data next = p pend data->NextPtr; 
mode = p tcb->FlagsOpt & OS_OPT PEND FLAG MASK; 





switch (mode) { 
Case OS OPT PEND FLAG SET ALL: 





flags rdy = (OS FLAGS) (P_grp->Flags & p tcb->FlagsPend); 


if (flags rdy == p tcb->FlagsPend) { 


OS_FlagTaskRdy (p_ tcb, 

flags_ rdy, 
ts); 

} 

break; 


Case OS OPT PEND FLAG SET ANY: 





flags rdy = (OS FLAGS) (p grp->Flags & p tcb->FlagsPend); 


if (flags rdy != (OS FLAGS)0) { 

OS FlagTaskRdy (p 1 te, 
lags_rdy, 
ts); 





外 


} 
break; 


#if OS CFG FLAG MODE CLR EN > Ou 
Case OS OPT PEND FLAG CLR ALL: 








flags rdy = (OS FLAGS) (~p grp->Flags & p tcb->FlagsPend) ， 


if (flags rdy == p tcb->FlagsPend) { 


OS_FlagTaskRdy (p_ tcb, 
flags rdy, 
ts); 

} 
break; 


Case OS OPT PEND FLAG CLR ANY: 





flags rdy = (OS FLAGS) (~p grp->Flags & p tcb->FlagsPend); 


if (flags rdy != (OS FLAGS)0) { 
OS_ FlagTaskRdy (p tcb, 

flags_ rdy, 
ts); 

} 

break; 

#engif 
default: 

OS_CRITICAL EXIT(); 

*p err = OS ERR FLAG PEND OPT; 

return ((OS FLAGS)0); 





p pend data = p pend data next; 





if (p pend data != (OS PEND DATA *)0) 


p tcb = p pend : data->TCBPtr; 
} else { 
p tcb = (OS TCB *)0; 


{ 








101 } 
102 } 
103 OS CRITICAL EXIT NO SCHED(); 
104 
105 // 根据 选项 决定 是 否 进 行 任务 调度 
106 if ((opt & OS OPT POST NO SCHED) = (OS OPT)0) { 
107 OSSched (); 
108 } 
109 
110 CPU CRITICAL ENTER(); 
A flags cur = p grp->rFlags; 
112 CPU CRITICAL EXIT(); 
TL3 *p_err = OS ERR NONE; 
114 // 返回 目前 已 经 设置 的 标志 位 的 情况 
115 return (flags cur); 
16 } 


第 20~35 行 根据 用 户 提交 时 设 定 的 选项 进行 相应 位 的 设置 ， 设 置 后 的 标志 保存 在 事件 标志 组 的 Flags 元 素 中 。 


第 50~102 行 在 有 其 他 的 任务 等 待 事件 标志 组 相应 位 被 设置 的 时 候 ， 人 遍历 所 有 等 待 的 任务 ， 一 个 个 检查 事件 标志 组 设置 的 位 是 否 就 是 任务 要 等 待 
的 设置 情况 ， 检 查 的 过 程 跟 OsFlagPends 是 一 样 的。 涉及 等 待 列表 数据 结构 的 操作 请 参见 信号 量 等 待 列 表 的 操作 以 及 图 示 。 


8.6 辟 结 


使 用 事件 标志 最 重要 是 要 将 其 和 位 联系 起 来 ， 但 事件 标志 组 又 不 仅仅 是 设置 位 和 清除 位 ， 还 要 在 位 的 设置 情况 符合 用 户 设 定 的 时 候 进行 等 待 列表 
的 管理 。 在 分 析 前 面 一 些 内 核对 象 的 基础 上 来 看 事件 标志 会 是 很 简单 的 一 个 过 程 ， 其 最 大 的 不 同 就 是 多 了 一 些 标志 位 的 设置 和 判断 ， 标 志 位 的 设置 过 
程 由 于 位 的 设置 情况 有 很 多 种 而 变 得 比较 繁琐 ， 但 是 万 变 不 离 其 宗 。 


了 解 信号 量 和 消息 队列 后 便 可 开始 学 习 本 章 内 容 。 本 章 的 内 容 很 少 ， 因 为 等 待 多 个 内 核对 象 是 在 前 面 的 等 待 各 个 内 核对 象 的 基础 上 拓展 出 来 的 ， 
这 里 多 个 内 核对 象 只 能 是 信号 量 和 消息 队列 的 组 合 。 等 待 多 个 内 核对 象 在 脱离 等 待 状态 的 时 候 将 相关 的 信息 (消息 内 容 字 节 大 小 、 消 息 内 容 的 指针 
等 ) 都 存储 在 我 们 调用 OSPendM ulti 阔 数 之 前 定义 的 OS_PEND_DATA 类 型 的 数组 里 面 ， 所 以 读者 最 好 复习 下 OS_PEND_DATA 这 个 数据 类 型 。 

















9.1 实例 演示 





在 实例 9-1 中 ， 我 们 用 等 待 多 个 内 核对 象 的 函数 OSPendMulti 来 等 待 消息 和 信号 量 ， 若 其 中 之 一 发 布 ， 则 LED1 改 变 状态 。 消 息 的 发 送 周 期 是 
1s， 所 以 一 般 情况 下 灯 闪 烁 的 周期 是 2s。 但 是 如 果 按 键 1 被 按 下 后 发 送 一 个 信号 量 ， 那 么 任务 会 解除 等 待 状态 ， 灯 的 状态 将 提前 改变 ， 串 口 打印 消息 
如 图 9-1 所 示 ， 主 要 代码 见 代码 清单 9-1。 








接收 到 消息 ，PC1 管 脚 的 电压 是 


115200 


按键 被 按 下 ， 接 收 到 1 
PE 

按键 被 按 下 ， 接 收 至 
接收 到 消息 ，PC1 管 脚 的 
EE 

接收 到 消息 ， 
按键 被 按 下 ， 接 收 到 信 
PE 








文件 路 径 ， 还 没 选择 要 发 送 的 文件 
素 口 已 开启 


代码 清单 9-1 等 待 多 个 内 核对 象 后 获取 消息 

















. 409106V 
. 409106V 


. 409106V 
- 409106V 


. 409106V 


-409912V 


接收 字 节 数 : 1009 ” 发 送 字 节 数 : 


EE 








例 程 9-1 串 口 打印 消息 


1 while (1) 
2 1 
3 // 等 待 AD 采 集 发 送 数据 (1Hz) 或 者 按键 按 下 后 发 送信 号 量 
4 OSPendMulti ((OS PEND DATA *)MyPendArray, // 内 核对 象 数组 
5 (OS_OBJ QTY )2; // 总 共 等 待 两 个 内 核对 象 
6 (OS_TICK ) 0， // 永远 地 等 待 下 去 
7 (OS_OPT )OS_OPT PEND BLOCKING, 
8 (OS_ERR *) &err); 
9 // 灯 政 变 状态 
10 LED1 TOGGLE; 
J // 如 果 让 任务 就 绪 的 是 队列 
12 if (MyPendArray[0] .RdyObjPtr==(OS PEND OBJ *) (&Queue)) { 
13 Pp_ReceiveData=MyPengdArray[0]. RdyMsgPtr; 
14 // 数据 处 理 
15 ADC_ConvertedValueLocal=(*p_ ReceiveData) *3.3/4096; 
16 // 放 回 内 存 块 
三 了 OSMemPut ((OS MEM *)&MemOfAD, 
18 (void *)p_ ReceiveDatayv 
上 9 (OS ERR *)&err); 
20 
21 printf("\r\n 接 收 到 消息 ，PC1 管 脚 的 电压 是 : %fV\r\n",ADC ConvertedValueLocal); 
2 之 } else if (MyPendArray[1] .RdyObjPtr==(OS PEND OBJ *) (&SemOfKey)) { 
23 // 如 果 让 任务 就 绪 的 是 信号 量 ( 按 键 ) 
24 printf (“\r\n 按 键 被 按 下 ， 接 收 到 信号 量 \r\n"); 
25 } 
26 1} 


冰 数 OSPendMulti 用 于 同时 让 任务 等 待 多 个 信号 量 5 


相应 的 内 核对 象 则 要 先 将 对 应 的 宏 置 1。 比 如 等 待 的 多 个 内 核对 象 中 有 信和 号 量 ， 


消息 队列 ， 并 且 只 要 有 一 个 提交 ， 


任务 就 解除 等 待 状态 。 注 意 ， 调 用 这 个 函数 时 ， 若 使 用 
就 要 将 OS_CFG_SEM_EN 这 个 宏 置 1， 表 示人 允许 使 用 信号 量 。 


参数 


1) p_pend_data_tbl: 在 调用 OSPendMulti 之 前 ,必须 先 定义 一 个 数组 ， 数 组 的 格式 如 下 。 数 组 的 大 小 跟 等 待 的 内 核对 象 的 个 数 一 样 。 之 后 将 
数组 的 首 地 址 赋 给 这 个 参数 即 可 。 


OS_PEND DATA MyPendArray[?]; 


定义 完 数组 之 后 还 要 将 定义 的 内 核对 象 变量 指针 赋 给 每 个 数组 元 素 的 PendObjPtr 元 素 。 将 数组 元 素 跟 要 等 待 的 内 核对 象 对 应 起 来 ， 如 代码 清单 
9-2 所 示 。 


上 | 





代码 清单 9-2 等待 多 个 内 核对 象 之 前 对 数组 的 初始 化 


1 // 初始 化 要 等 待 的 多 个 内 核对 象 
2 MyPendArray[0] .PendObjPtr= (OS PEND OBJ *) &Queue; 
3 MyPendArray[1] .PendObjPtr=(OS PEND OBJ *) &SemOfKey; 














2) tbl_size: 等 待 的 内 核对 象 个 数 ， 例 程 中 等 待 了 一 个 消息 队列 和 一 个 信号 量 ， 所 以 这 个 参数 就 是 2。 
3) timeout: 任务 一 开始 获取 不 到 信号 量 等 待 的 节拍 数 。 若 输入 0 表示 无 限期 地 等 待 。 

4) opt: 选项 可 分 为 以 下 两 种 。 

" OS_OPT_PEND_BLOCKING: 一 开始 获取 不 到 信号 量 就 阻塞 任务 ， 阻 塞 的 时 候 根 据 参 数 timeout 决 定 。 


* OS_OPT_PEND_NON_BLOCKING: 一 开始 获取 不 到 信号 量 就 退出 函数 ， 继 续 运 行 任务 。 





5) p_ts: 指向 等 待 的 内 核对 象 被 删除 、 等 待 被 强制 停止 、 等 待 超时 等 情况 时 的 时 间 戳 的 指针 。 这 个 参数 输入 空 指针 表示 不 想 获取 时 间 戳 。 
6) p_err: 指向 返回 错误 类 型 的 指针 ， 主 要 有 以 下 几 种 类 型 (只 包含 部 分 ) 。 

. OS_ERR_OBJ_TYPE: 数组 在 赋值 的 时 候 PendObjPtr 元 素 出 错 ， 必 须 是 信号 量 或 者 消息 队列 的 相关 变量 指针 。 

. OS_ERR_PEND_ABORT: 返回 的 时 候 不 是 因为 内 核对 象 发 布 ， 而 是 被 强制 解除 等 待 状态 。 


" OS_ERR_PEND_WOULD_BLOCK: 没有 获取 到 内 核对 象 ， 输 入 的 参数 选项 是 OS_OPT_PEND_NON_BLOCKING 的 时 候 。 








. OS_ERR_SCHED_LOCKED: 调度 器 被 锁 住 。 


. OS_ERR_TIMEOUT: 等 待 内 核对 象 超时 。 


函数 OSPendM ulti 源 码 见 代码 清单 9-3。 


代码 清单 9-3 等待 多 个 内 核对 象 的 函数 OSPendMulti 

















1 OS OBJ QTY OSPendMulti (OS PEND DATA *p pend data tbl, 
2 OS_OBJ QTY tbl size, 
3 OS_TICK timeout, 
4 OS_OPT opt, 
与 OS_ERR err) 
6 { 
过 CPU BOOLEAN valid; 
8 OS_OBJ QTY nbr obj rdy; 
9 CPU SR ALLOC(); 
0 
下 
2 
3 #ifdef OS_SAFPTY _ CRITICAL 
4 if (p err == (OS ERR *)0) { 
5 OS_SAFETY CRITICAL EXCEPTION(); 
6 return ((OS OBJ QTY) 0) 7 
y } 
8 #engif 
19 
20 #if OS CFG CALLED FROM ISR CHK EN > 0u 
21 if (OSIntNestingCtr > (OS NESTING CTR) 0) { 
22 *p err = OS ERR PEND ISR; 
23 return ((OS OBJ QTY)0); 
24 } 
25 #endif 
26 


27 #if OS_CFG ARG CHK EN > Ou 


28 // 定义 数组 的 首 地址 不 能 是 空 指针 





















































29 if (p pend gata tbl == (OS PEND DATA *)0) { 
30 *p err = OS ERR PTR INVALID; 
1 return ((OS OBJ QTY) 0) 7 
32 } 
33 // 数组 大 小 也 不 能 是 0 
34 if (tbl size == (OS OBJ QTY)0) { 
35 *p err = OS ERR PTR INVALID; 
36 return ((OS OBJ QTY)0); 
37 } 
38 // 检查 选项 
39 Switch (opt) { 
40 case OS OPT PEND BLOCKING: 
41 case OS OPT PEND 1 ON_BLOCKING: 
42 break; 
43 
44 default: 
45 *p err = OS ERR OPT INVALID; 
46 return ((OS OBJ QTY)0); 
47 
48 #enqdif 
49 
50 // 检查 数组 变量 的 元 素 PendObjPtr 是 不 是 只 指向 信号 量 和 消息 队列 
5 valid = OS PendMultiValigdate(p pend data tbl， 
52 tbl size); 
53 // 如 果 数 组 元 素 出 错 ， 退 出 
54 if (valid == DEF FALSE) { 
35 *p err = OS ERR OBJ TYPE; 
56 return ((OS OBJ QTY)0); 
57 } 
58 
59 /*$PAGE*/ 
60 CPU CRITICAL ENTER(); 
61 // 检查 是 否 有 内核 对 象 已 经 被 提交 
62 nbr obj rdy = OS PendMultiGetRdy (p pengd data tbl, 
63 tbl size); 
64 if (nbr obj rdy > (0OS OBJ QTY)0) { 
65 CPU CRITICAL ，EXIT () ， 
66 *p_ err = = OS ERR NONE; 
67 return ((OS OBJ QTY)nbr obj rdy); 
68 } 
69 
0 if ((opt & OS OPT PEND NON BLOCKING) != (OS OPT)0) { 
了 CPU ( CRITICAL , EXIT () ， 
72 *p err = OS ERR PEND WOULD BLOCK; 
73 return ((OS OBJ QTY)0); 
74 } else { 
375 if (OSSchedLockNestingCtr > (OS_ NESTING CTR)0) { 
76 CPU CRITICAL EXIT(); 
中 了 *p err = OS ERR SCHED LOCKED; 
78 return ((OS OBJ QTY)O0); 
79 } 
80 } 
81 OS CRITICAL ENTER CPU CRITICAL EXIT(); 
82 
83 // 插入 等 待 列表 
84 OS_ PendMultiWait (p pend data tbl, 
85 tbl size, 
86 timeout); 
87 
88 OS CRITICAL EXIT NO SCHED(); 
89 
90 OSSched () 
91 
92 CPU_CRITICAL ENTER(); 
93 switch (OSTCBCurPtr->PendStatus) { 
94 Case OS_STATUS _ PEND OK: 
95 *p err = 0OS ERR NONE; 
96 break; 
97 
98 Case OS_STATUS_ PEND ABORT: 
99 *p err = OS ERR PEND ABORT; 
100 break; 
101 
102 case OS_STATUS PEND TIMEOUT: 
103 *p err = OS ERR TIMEOUT; 
104 break; 

05 
106 case OS_STATUS PEND DEL: 
107 *p err = OS ERR OBJ DEL; 
108 break; 
109 
TO default: 
1 *p err = OS ERR STATUS INVALID; 
112 break; 
113 } 
114 
115 OSTCBCurPtr->PendStatus = OS_STATUS PEND OK; 
116 CPU CRITICAL EXIT(); 
117 
118 return ((OS OBJ QTY)1); 

19. } 











讲解 等 待 多 个 内 核对 象 这 个 过 程 前 ， 先 让 我 们 大 致 总 结 下 等 待 多 值 信号 量 、 消 息 队列 、mutex、 事 件 标志 这 些 内 核对 象 的 过 程 。 首 先 检查 所 等 待 
的 内 核对 象 是 否 已 经 被 提交 过 ， 如 果 被 提交 过 了 ， 那 么 直接 返回 。 如 果 没 有 被 提交 过 ， 那 么 就 将 任务 置 于 等 待 状态 ， 执 行 就 绪 列表 中 优先 级 最 高 的 任 
务 ， 直 到 等 待 状态 被 解除 。 等 待 状态 被 解除 可 能 有 多 种 原因 ， 比 如 其 他 任务 已 经 提交 了 相应 的 内 核对 象 ， 或 者 内 核对 象 被 其 他 任务 删除 、 任 务 被 强制 


解除 等 待 状 态 、 等 待 超时 等 。 等 待 状态 被 解除 后 任务 若是 处 于 就 绪 列 表 中 优先 级 最 高 的 位 置 ， 就 获得 CPU 的 使 用 权 并 且 返 回 相应 的 错误 以 便 调 用 者 知 
道 函 数 为 何 返 回 。 








代码 清单 9-3 的 第 51、52 行 调用 函数 OS_PendM ultiValidate 检 查 等 待 的 对 象 是 否 只 是 消息 队列 和 信号 量 ， 这 个 函数 比较 简单 ， 不 做 分 析 。 
第 62~68 行 首先 调用 OS_PendM ultiGetRdy 并 根据 返回 值 判 断 等 待 的 多 个 内 核对 象 中 是 否 有 已 经 被 提交 的 ， 如 果 有 ， 那 么 直接 返回 。 
第 84~90 行 调用 OS_PendMultiWait 将 任务 置 于 等 待 状态 后 进行 任务 调度 ， 其 他 任务 获得 CPU 的 使 用 权 。 


第 92~116 行 主要 是 任务 解除 等 待 状态 重新 获得 CPU 使 用 权 后 处 理 错 误 。 


9.3” 忆 结 


AGN2 口 








本 章 是 建立 在 信号 量 和 消息 队列 两 个 章节 的 基础 上 的 。 理 解 了 前 面 信号 量 和 消息 队列 的 操作 之 后 就 可 以 很 容易 地 理解 等 待 多 个 内 核对 象 的 操作 。 
回顾 一 下 信号 量 在 提交 内 核对 象 的 时 候 需 要 等 待 多 个 内 核对 象 的 情况 ， 可 以 更 好 地 理解 本 章 中 解除 等 待 状态 后 获取 消息 的 代码 段 ， 如 代码 清单 9-1。 


第 10 章 ”任务 消息 队列 和 任务 信号 量 





在 实际 任务 间 的 通信 中 ， 一 个 任务 发 送 一 个 信号 量 或 者 消息 给 另 一 个 任务 是 比较 常见 的 ， 而 多 个 任务 发 送 给 一 个 任务 的 情况 相对 来 说 比较 少 。 储 
务 信号 量 、 任 务 消息 队列 与 单纯 的 信号 量 和 消息 队列 相 比 ， 主 要 有 以 下 几 点 不 同 。 





1) 功能 上 没有 多 个 任务 等 待 同 一 个 信号 量 或 消息 队列 ， 任 务 有 且 只 有 一 个 。 所 以 数据 结构 中 可 以 省 去 用 于 管理 多 个 等 待 任务 的 等 待 队列 ， 操 作 
上 没有 等 待 队列 的 相关 操作 。 所 以 本 章 比 消息 队列 、 信 号 量 的 章节 简单 。 








2) 在 学 习 任 务 消息 队列 或 者 任务 信号 量 的 时 候 ， 最 重要 的 是 要 意识 到 它们 都 是 依附 于 任务 存在 的 。 管 理 它 们 的 数据 结构 在 任务 控制 块 上 ， 它 们 
的 相关 操作 也 是 与 任务 控制 块 相 关 的 ， 除 非 任务 被 删除 ， 否 则 它们 不 能 被 删除 。 而 消息 队列 和 信号 量 是 独立 于 任务 存在 的 ， 它 们 相关 联 的 是 内 核对 象 
相关 变量 。 


3) 如 果 能 用 任务 消息 队列 和 任务 信号 量 满足 需求 ， 就 尽量 不 要 用 消息 队列 和 信号 量 ， 因 为 前 者 操作 更 简单 ， 也 更 省 时 。 





本 章 中 ，“ 消 息 队 列 ” 都 指 单纯 的 消息 队列 ， 而 不 是 任务 消息 队列 。 


10.1 实例 演示 


实例 10-1 运 用 了 任务 消息 队列 来 接收 串口 数据 ， 然 后 再 将 这 些 数据 通过 串口 打印 出 来 ， 如 图 10-1 所 示 。 


使 用 任何 跟 任务 消息 队列 相关 的 函数 之 前 ， 一 定 要 确保 创建 任务 的 时 候 已 经 把 参数 q_size 设 置 为 合适 的 大 小 ， 不 然 提 交 信 号 量 的 时 候 就 会 出 错 。 
使 用 提交 任务 信号 量 函数 ODSTaskQPost 后 发 现任 务 消息 队列 使 用 出 错 了 ， 就 会 通过 串口 打印 出 返回 的 错误 ， 得 到 26003。 这 个 错误 正 是 
OS_ERR_Q_MAX 的 值 ， 表 示 队 列 已 满 。 之 前 没有 用 到 任务 消息 队列 ， 因 而 忽视 了 这 个 变量 ， 直 接 将 它 设置 为 0 敷衍 了 事 。 正 确 的 设置 如 代码 清单 10- 
1 所 示 ， 我 们 设置 任务 消息 队列 时 最 多 可 以 存放 200 个 消息 。 
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图 10-1 例 程 10-1 串 口 打 印 数据 


代码 清单 10-1 创建 任务 时 设 定 任务 消息 队列 的 容量 








1 // 创建 等 待 消息 队列 任务 

2 OSTaskCreate ( (OS_TCB *) &PEND Q TCB, // 任务 控制 块 指 针 

< (CPU CHAR  *)"Pend Q Task", // 任务 名 称 

4 (OS_ TASK PTR )Task Penqo， // 任务 代码 指针 

5 (void *) 0, // 传递 给 任务 的 参数 parg 
6 (OS_PRIO ) TASK PEND Q PRIO, // 任务 优先 级 

7 (CPU STK *)&Pengo Stk[0], // 任务 堆栈 基地 址 

8 (CPU STK SIZE)TASK PEND Q STK SIZE/10, // 堆栈 剩余 警戒 线 

9 (CPU STK SIZE) TASK PEND © STK SIZE, // 堆栈 大 小 

10 (OS MSG QTY )200, // 可 接收 的 最 大 消息 队列 数 
而 (OS TICK )0; // 时 间 片 轮转 时 间 

1 (void *) 0, // 任务 控制 块 扩展 信息 
13 (OS_OPT ) (OS_OPT TASK STK CHK | 

14 OS_ OPT TASK STK CLR), // 任务 选项 

15 (OS_ERR *) &err); // 返回 值 





消息 队列 是 用 结构 体 OS_Q 来 管理 的 ， 包 含 了 管理 消息 的 元 素 MsgQ 和 管理 等 待 队列 的 元 素 PendList 等 。 具 体 可 以 参考 消息 队列 的 相关 章节 。 图 
10-2 展 示 了 FIFO 和 LIFO 的 时 候 任 务 消息 队列 的 数据 结构 。 对 比 消息 队列 可 以 看 到 ， 少 了 等 待 列 表 ， 只 有 元 素 MsgQ 放 在 任务 控制 块 中 管理 消息 
为 等 待 任务 消息 队列 只 有 拥有 任务 消息 队列 本 身 的 任务 才 可 以 进行 ， 故 任务 消息 队列 不 需要 等 待 队列 的 相关 数据 结构 。 
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图 10-2 ”任务 消息 队列 数据 结构 


10.3 ”任务 信号 量 


通过 前 几 节 对 于 任务 消息 队列 和 消息 队列 的 操作 的 分 析 可 知 ， 它 们 的 区 别 仅仅 在 于 任务 消息 队列 不 用 处 理 等 待 列表 的 相关 操作 ， 具 体 体现 在 调用 
OS_Post、OS_Pend、OS_PendAbort 这 些 函 数 的 时 候 与 等 待 列表 相关 的 参数 直接 置 0。 任 务 信 号 量 跟 之 前 讲 过 的 多 值 信号 量 的 区 别 也 在 于 此 。 


互 三 星 


第 11 章 ”内存 管理 


在 分 配 和 释放 内 存 频繁 的 地 方 会 造成 大 量 的 内 存 碎片 ，hC/OS- 员 提供 了 一 种 内 存 管理 的 方式 以 快速 高 效 地 分 配 内 存 。 本 章 首先 介绍 内 存 碎片 的 
形成 ， 再 介绍 内 存 管理 相关 的 数据 结构 ， 最 后 讲解 内 存 管理 的 内 部 机 制 。 


11.1 内 存 碎片 是 号 么 形成 的 


为 很 多 离散 的 小 块 内 存 ， 称 为 内 存 碎 片 。 下 面 举例 i 
最 后 内 存 的 情况 有 可 能 如 图 11-1 所 示 。 黑 色 条 纹 填充 的 方 框 表示 还 在 被 占用 。 这 时 
块 不 足 ， 还 剩 下 6 块 内 存 空间 ， 只 不 过 它们 是 不 连续 的 。 


在 不 断 分 配 和 释放 内 存 的 过 程 中 ， 一 整 块 连续 的 内 存 被 分 散 
设 有 8 块 连续 的 内 存 空间 都 被 分 配 使 用 了 ， 后 来 又 有 一 些 被 释放 ， 
如 果 要 分 配 3 块 连续 的 内 存 空间 就 无 法 分 配 了 ， 但 并 不 是 因为 内 存 
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图 11-1 内 存 碎片 的 形成 


内 存 管理 就 是 为 了 避免 产生 过 多 的 内 存 碎 片 。 大 致 思路 是 一 次 性 取出 较 多 的 内 存 空 间 ， 将 多 个 内 存 块 (只 能 是 4、8、16 等 固定 的 字 节 数 ) 串 成 
单 向 链表 ， 组 成 内 存 分 区 。 每 次 要 用 到 内 存 块 就 从 内 存 分 区 中 取出 一 块 ， 用 完 再 放 回 去 。 这 跟前 面 介绍 的 消息 池 原 理 是 一 样 的 。 这 种 内 存 管理 方式 所 
需 的 时 间 很 短 ， 效 率 很 高 ， 但 是 在 同一 个 内 存 分 区 中 每 次 请 求 的 内 存 块 只 能 是 固定 大 小 的 字 节 。 





11.2 实例 涪 明 








在 例 程 7-1 中 ， 将 消息 队列 跟 内 存 块 一 起 使 用 ， 这 两 者 的 使 用 是 绝妙 的 。 首 先 获取 一 个 消息 队列 和 内 存 分 区 ， 然 后 获取 一 个 内 存 块 ， 放 入 采集 好 
的 AD 值 ， 接 着 通过 队列 发 送 到 另 一 个 任务 ， 另 一 个 任务 接收 好 了 这 个 消息 ， 处 理 好 AD 值 后 释放 内 存 块 。 反 复 循环 ， 不 会 形成 内 存 碎片 。 


11.3 内存 分 区 控制 块 数据 结构 


内 存 分 区 控制 块 数据 结构 如 图 11-2 所 示 ， 我 们 可 以 看 到 部 分 元 素 我 们 是 很 熟悉 的 ，Type 代 表 内 核对 象 的 类 型 ，NamePtr 存 放 指 向 内 存 控制 块 名 
称 字符 串 的 指针 ，DbgPrevPtr、DbgNextPtr 用 于 将 多 个 内 存 控制 块 按照 创建 时 间 的 顺序 串 成 双向 链表 。 下 面 介绍 其 他 一 些 元 素 的 含义 。 
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图 11-2 内存 控制 块 的 数据 结构 





* AddrPtr: 保存 内 存 控制 块 的 起 始 地 址 。 

“ FreeListPtr: 保存 第 一 个 可 用 内 存 块 的 地 址 。 
" BlkSize: 内 存 分 区 中 内 存 块 大 小 。 

* NbrMax: 内 存 分 区 中 内 存 块 总 个 数 。 

" NbrFree: 内 存 分 区 中 内 存 块 剩 下 的 个 数 。 


代码 清单 11-1 是 一 个 内 存 分 区 创建 函数 OSMemCreate 的 范例 ， 调 用 函数 之 前 定义 一 个 数组 来 为 内 存 分 区 分 配 内 存 ， 并 将 数组 首 地 址 作为 函数 参 
数 输 入 。 


代码 清单 11-1 内 存 分 区 创建 示例 





1 // 使 用 内 存 分 区 之 前 要 定义 一 个 内 存 空间 ， 每 个 内 存 块 4 个 字 节 ， 内 存 分 区 内 一 共 20 个 内 存 块 




















2 uint8 七 AD Buf[20] [4]; 

3 OS MEM MemOfAD; 

4 // 创建 内 存 分 区 

5 OSMemCreate ((OS MEM *) EMemOfAD, // 指向 内 存 分 区 指针 

6 (CEU_ CHAR *) "MemOfAD"， // 字符 串 名 称 

也 (void ey Buf, // 内 存 分 区 首 地 址 

8 (OS_ MEM QTY . // 内 存 分 区 中 内 存 块 的 个 数 

9 (OS MEM SIZE 

10 // -大 甘 内 在 燃 的 所 占 的 字 节 大 小 ， 由 于 要 内 存 对 齐 ， 这 个 数 一 定 要 是 4 的 倍数 
1 (OS_ERR *) &err); 





11.4 创建 内 存 分 区 


创建 内 存 分 区 之 前 必须 先 定义 一 块 较 大 的 内 存 ， 然 后 使 用 OSMemCreate 函 数 就 可 以 创建 出 一 块 内 存 分 区 。 内 存 分 区 一 经 创建 便 不 能 删除 ， 系 统 
没有 提供 相应 的 删除 函数 。 其 参数 包含 以 下 几 个 。 


1) p_mem: 指向 内 存 分 区 控制 块 变量 的 指针 。 

2) p_name: 指向 内 存 分 区 名 称 字 符 串 的 指针 。 

3) n_blks: 内 存 分 区 中 内 存 块 的 块 数 。 

4) blk_size: 每 个 内 存 块 的 字 节 大 小 ， 在 所 用 的 硬件 中 ， 这 个 数 必 须 大 于 等 于 4 目 必须 是 4 的 倍数 。 

5) p_addr: 指向 整 块 内 存 分 区 的 首 地 址 。 

6) p_err: 指向 返回 错误 的 指针 ， 可 为 以 下 几 种 情况 。 

* OS_ERR_MEM_INVALID_BLKS: 参数 n_blks 不 符合 条 件 ， 要 求 这 个 数 要 大 于 等 于 2。 不 然 内 存 分 区 的 创建 就 失去 了 意义 。 
* OS_ERR_MEM_INVALID_P_ADDR: 参数 p_addr 是 空 指针 或 者 这 个 地 址 没有 进行 数据 对 齐 。 


为 了 便于 理解 ， 首 先 介绍 32 位 总 线 的 CPU 是 如 果 读 取 一 个 Byte 数 据 类 型 的 。CPU 一 次 只 会 从 4 倍数 开始 的 地 址 一 次 性 读 取 32 位 数 (数据 总 线 宽 
度 ) 放 到 缓存 里 。 然 后 根据 需要 剔除 不 要 的 部 分 ， 拼 合 、 移 位 后 传输 到 内 部 寄存 器 里 ， 保 证 内 部 寄存 器 里 的 数据 总 是 正确 内 容 。 也 就 是 说 ，1 字 节 的 
数据 读 取 时 肯定 能 读 到 。2 字 节 的 数据 可 能 跨 4 倍 数 的 界限 ， 这 时 就 需要 两 个 访 存 周期 读 取 48 位 数 ， 然 后 拼合 并 剔除 不 要 的 部 分 。 这 个 过 程 是 很 浪费 
时 间 的 ， 因 此 数据 对 齐 有 利于 CPU 快速 读 取 数 据 。 


. OS_ERR_MEM_INVALID_SIZE: 创建 内 存 分 区 的 时 候 ， 要 将 分 区 中 的 各 个 内 存 块 串 成 单 向 链表 ， 前 一 个 内 存 块 必须 要 有 足够 的 内 存 来 放置 下 
一 个 内 存 块 的 地 址 。 在 创建 内 存 分 区 的 时 候 会 以 这 个 条 件 来 判断 内 存 块 的 字 节 大 小 是 否 合适 ， 并 且 在 hnC/OS-II 中 要 求 每 个 内 存 块 的 大 小 必须 是 指针 
大 小 的 整数 倍 。 


函数 OSMemCreate 的 源码 如 代码 清单 11-2 所 示 。 


代码 清单 11-2 ”创建 内 存 分 区 函数 OSMemCreate 


















































1 void OSMemCreate (OS MEM *p_mem, 
2 CPU_CHAR *p_name, 
过 void *p_agdgr, 
4 OS MEM QTY n blks, 
二 OS MEM SIZE blk size, 
6 OS_ERR *p_err) 
7 { 
8 #if OS CFG ARG CHK EN > Ou 
9 CPU_DATA align msk; 
10 #engdif 
11 OS_MEM QTY 于 
12 OS_MEM QTY loops; 
13 CPU INT08U *p blk; 
14 void 二 站 Lirk; 
15 CPU SR ALLOC () ; 
16 
47 
18 
19 #ifdef OS_SAFETY CRITICAL 
20 if (p err == (OS ERR *)0) { 
用] OS_SAFETY CRITICAL EXCEPTION(); 
22 returny 
23 } 
24 #endif 
25 
26 #ifdef OS_SAFETY CRITICAL IEC61508 
27 if (OSSafetyCriticalStartFlag == DEF TRUE) { 
28 *p err = OS ERR ILLEGAL CREATE RUN TIME; 
29 return; 
30 } 
31 #enqif 
32 
33 #if OS CFG CALLED FROM ISR CHK EN > 0u 
34 if (OSIntNestingCtr > (OS NESTING CTR) 0) { 
39 *p et = OS ERR MEM CREATE ISR; 





36 return; 


} 
38 #enqif 


40 #if OS CFG ARG CHK EN > 0u 




































































41 // 检查 内 存 分 区 首 地 址 是 不 是 空地 址 

42 if (p aqqr == (void *)0) { 

43 Br = OS ERR MEM INVALID P ADDR; 
44 return; 

45 } 

46 // 内 存 块 的 数量 必须 大 于 2 

47 if (n blks < (OS MEM QTY)2) { 

48 *p err = OS ERR MEM INVALID BLKS; 

49 return; 

50 } 

51 // 控制 块 的 大 小 必须 大 于 一 个 指针 的 大 小 

52 if (blk size < sizeof(void *)) { 

53 *p err = OS ERR MEM INVALID SIZE; 

54 return; 

55 } 

56 // 检查 内 存 分 区 首 地 址 是 否 有 数据 对 齐 ， 内 存 分 区 块 的 大 小 是 否 是 4 的 倍数 
57 align msk = sizeof (void *) - lu; 

58 if (align msk > 0) { 

59 if (((CPU ADDR)P aqqr & align msk) != 0u) { 
60 *p err = OS ERR MEM INVALID P ADDR; 
61 retrny 

62 } 

63 if ((blk size & align msk) != 0u) { 
64 *p err = OS ERR MEM INVALID SIZE; 
65 } 

66 } 

67 #endif 

68 

69 // 将 内 存 块 串 成 单 向 链表 

70 p link = (void **)p agqdr; 

ZE p blk = p adgr; 

72 loops = n blks - lu; 

区 for (i = Ou; i < loops; i++) { 

74 p blk +=. blk size; 

2 *p link = (void *)p: blk; 

76 p link = (void **) (Volid *)p blk; 

了 } 

78 *p_ link = (void *)0; 

79 

80 OS_CRITICAL ENTER(); 

81 // 初始 化 内 存 分 区 变量 元 素 

82 p_mem->Type = OS_ OBJ TYPE MEM; 

83 Pp_mem->NamePtr = p_name; 

84 p_mem->AddrPtr = p_addr; 

85 p_mem->FreeListPtr = p_ addr; 

86 P_mem->NprFree = n blks; 

87 Pp_mem->NbrMax = n blks; 

88 p_mem->BlkSize = blk size; 

89 


90 #if OS CFG DBG EN > 0u 
91 // 将 内 存 分 区 变量 插入 调试 列表 


92 OS MemDbgListAdd (p mem); 
93 #engif 

94 

95 // 内 存 分 区 数量 +1 

96 OSMemOty++; 

97 

98 OS_CRITICAL EXIT(); 

39 *p err = OS ERR NONE; 
L100. 





代码 清单 11-2 的 第 52~55 行 用 于 检查 内 存 块 的 字 节 大 小 是 否 大 于 指针 所 占用 的 字 节 大 小 ， 前 一 个 内 存 块 必须 要 有 足够 的 内 存 来 放置 下 一 个 内 存 块 


的 地 址 。 


第 57~66 行 用 于 检测 地 址 是 否 有 数据 对 齐 和 内 存 块 字 节 大 小 是 否 为 4 的 倍数 。sizeof (void*) 用 于 求 出 CPU 指 针 的 字 节 大 小 。STM32 是 32 位 单 片 
机 ， 求 出 的 指针 所 占 字 节 大 小 是 4， 减 去 1 后 就 是 3，3 的 二 进 制 数 是 11 (B) 。 如 果 一 个 地 址 或 者 内 存 块 字 节 大 小 是 4 字 节 对 齐 的 ， 那 么 用 二 进 制 表示 


地 址 或 内 存 块 大 小 最 低 两 位 都 是 0， 比 如 11100 (B) 、1010 
是 4 字 节 对 齐 。 同 理 可 以 检测 内 存 块 的 大 小 是 否 是 4 的 倍数 。 


第 70~78 行 在 分 析 的 时 候 给 人 一 种 似曾相识 的 感觉 ， 在 ; 





10100 (B) 等 ,那么 11 (B) 与 上 一 个 低 两 位 字 节 都 是 0 的 数 结果 肯定 为 0， 不 为 0 说 明 不 





肖 息 池 的 创建 函数 OS_ MsgPoolCreate 中 也 有 部 分 功能 类 似 的 代码 ， 都 是 将 数组 中 的 元 素 


串 成 单 向 链表 。 串 上 一 个 内 存 块 的 操作 是 先 计算 是 下 一 个 内 存 块 的 地 址 ， 因 为 数组 元 素 的 地 址 是 连续 的 ， 所 以 开始 的 时 候 只 要 在 前 一 个 内 存 块 的 首 地 
址 加 上 内 存 块 字 节 大 小 即 可 得 到 下 一 个 内 存 块 的 首 地 址 。 然 后 把 下 一 个 内 存 块 的 首 地 址 放 在 前 一 个 内 存 块 ， 就 将 他 们 串 起 来 了 。 如 此 循环 即 可 串 成 内 


存 分 区 ， 图 11-3 展 示 了 内 存 分 区 形成 后 的 情况 。 


产 一 黑色 代表 内 存 块 起 始 地 址 ， 日 色 代 表 地 址 指向 的 内 容 


内 存 块 





内 存 分 区 





11.5 ”获取 内 存 块 


函数 OSMemGet 用 来 获取 内 存 块 。 


1. 参 数 


1) p_mem: 指向 内 存 分 区 控制 块 的 指针 。 


2) p_err: 指向 返回 错误 的 指针 ， 可 能 为 以 下 几 种 类 型 。 





p addr 所 一 一 p mem->AddrPtr 
十 p mem->FreeListPtr 


P addr+blk size*l 


P addr+blk size*2 


P addr+blk size*(n blks-1) 


0 





图 11-3 ”创建 内 存 分 区 的 过 程 


“OS_ERR_MEM_INVALID_P_MEM: 参数 p_mem 是 空 指针 。 


. OS_ERR_MEM_NO_FREE_BLKS: 内 存 分 区 中 没有 剩 下 的 内 存 控制 块 。 





2. 返 回 值 


如 果 没 有 错误 ， 则 返回 内 存 块 的 首 地 址 。 如 果 出 现 错误 ， 则 返回 空 指针 。 


函数 OSMemGet 的 代码 如 代码 清单 11-3 所 示 。 


代码 清单 11-3 ”获取 内 存 块 函数 OSMemGet 








void *OSMemGet (OS MEM *p mem, 


{ 








OS ERR *p err) 





void *p 的] 
CPU SR ALLOC(); 


#ifdef OS SAFETY CRITICAL 
if ‘(perr == (OS ERR *)0) 1 


} 





OS_ SAFETY CRITICAL EXCEPTION(); 


return ((voiqd *)0); 


14 #enqif 



































| 

16 #if OS CFG ARG CHK EN > 0u 

1 if (p mem == (OS MEM *)0) { 

18 *p err = OS ERR MEM INVALID P MEM; 
19 return ((void *)0); 

20 } 

21 #endif 

22 

23 CPU_CRITICAL ENTER(); 

24 // 查看 是 否 还 剩 下 内 存 块 

25 if (p mem->NbrFree == (OS MEM QTY)0) { 
26 CPU CRITICAL EXIT(); 

27 *p err = OS ERR MEM NO FREE BLKS; 
28 return ((void *)0); 

29 } 

30 // 获取 内 存 块 地 址 

31 p_blk = Pp mem->FreeListPptr; 
32 // 调整 第 一 个 可 用 内 存 块 的 地 址 

33 p_ mem->FreeListPtr = *(void **)p blk; 
34 // 空闲 内 存 块 数量 -1 

35 Pp_mem->NbrFree-——; 

36 CPU_ CRITICAL EXIT (); 

37 *p err = OS ERR NONE; 

38 // 返回 获取 到 的 内 存 块 大 小 

39 return (p blk); 

40 } 





址 ; 


1 


A 


函数 OSMemGet 获 取 内 存 块 的 过 程 跟 获 取消 息 是 一 样 的， 都 是 从 单 向 链表 的 一 端 取 出 一 个 节 
接着 调整 内 存 分 区 的 变量 元 素 FreeListPtr 指 向 下 一 个 可 用 的 内 存 块 地 址 ， 控 制 内 存 块 数量 减 1; 最 后 返回 获取 到 的 内 存 块 地址 。 


.6 ”将 内 存 块 放 回 内 存 分 区 


函数 ODSMemPut 用 来 将 内 存 块 放 回 内 存 分 区 ， 下 面 介 


1) p_mem: 指向 内 存 分 区 控制 块 指针 。 


2) p_blk: 内 存 块 的 首 地 址 。 


绍 


3) p_err: 指向 返回 错误 的 指针 。 可 能 为 以 下 几 种 类 型 。 


“ OS_ERR_MEM_INVALID_P_MEM: p_mem 是 空 指针 。 


“ OS_ERR_MEM_INVALID_P_BLK: p_blk 是 空 指针 。 


. OS_ERR_MEM_FUILL: 内 存 分 区 已 满 。 


函数 OSMempPut 的 源码 如 代码 清单 11-4 所 示 。 


其 参 


过 


代码 清单 11-4 将 内 存 块 放 回 内 存 分 区 函数 ODSMemPut 


数 的 作用 。 


















































1 void OSMemPut (OS MEM *p mem, 

2 void *p_blk, 

3 OS ERR *p err) 

4 { 

5 CPU SR ALLOC(); 

6 

- 

8 

9 #ifdef OS_SAFETY CRITICAL 

10 if (p err == (OS ERR *)0) { 

下 OS _ SAFETY CRITICAL EXCEPTION () ; 
12 return; 

13 } 

14 #engif 

下 

16 #if OS CFG ARG CHK EN > 0u 

pb if (p mem == (OS MEM *)0) { 

18 *p err = OS ERR MEM INVALID P MEM; 
19 return; 
20 } 
21 if (p blk == (void *)0) { 
2 *p err = OS ERR MEM INVALID P BLK; 
23 return; 
24 } 
25 #engif 
26 
21 CPU CRITICAL ENTER(); 





点 。 首 先 获取 内 存 分 区 控制 块 的 第 一 个 内 存 块 的 地 


if 


(P 


CEU CRITICAL EXIT () ; 
*p_err = OS_ ERR MEM FULL; 





mem->NbrFree >= p mem->NbrMax) { 


returns 


} 
* (void **)p blk 


// 让 控制 块 变量 元 素 EreeListPtr 指 向 插入 的 内 存 块 地 址 


= p mem->FreeListptr; 


p_mem->FreeListPtr = p blk; 


// 可 用 内 存 块 数量 +1 
p_mem->NbrFreett; 
CPU_ CRITICAL EXIT(); 
“pb ,Er 


= OS_ERR NONE; 





放 回 内 存 块 的 过 程 即 是 将 一 个 节点 放 回 单 向 链表 的 过 程 。 第 33 行 用 于 链接 前 面 FreeListPtr 指 向 的 内 存 块 地 址 和 新 插入 的 内 存 块 地 址 ， 第 35 行 用 
于 将 FreeListPtr 指 向 插入 的 内 存 控制 块 的 地 址 。 


11.7 


总 疆 


| 


为 了 减少 内 存 碎 片 ，hC/OS- 员 有 可 供用 户 使 用 的 内 存 分 区 管理 。 内 存 分 区 就 是 一 个 单 向 链表 ， 多 个 数据 在 频繁 释放 的 时 候 可 以 从 内 存 分 区 中 获 
取 这 个 单 向 链表 中 的 插入 节点 。 


第 12 章 


就 绪 优先 级 位 映像 表 


在 任务 调度 的 时 候 ， 首 先 要 查找 出 就 绪 的 任务 中 优先 级 比较 高 的 任务 ， 然 后 再 使 其 就 绪 。hC/OS- 咱 可 以 拥有 无 数 个 优先 级 ， 而 一 个 优先 级 又 可 
以 有 无 数 多 个 任务 ， 所 以 ， 当 任务 比较 多 的 时 候 ， 如 果 采 用 普通 的 办 法 查找 是 相当 麻烦 的 。 本 章 讲解 的 就 绪 优先 级 位 映像 表 可 以 方便 查找 出 优先 级 最 
高 的 就 绪 任务 所 在 的 优先 级 。 


12.1 


就 绪 优先 级 位 映像 表 数 据 结构 


HC/OS- 员 定义 了 一 个 数组 OSPrioTbl[OS_PRIO_TBL_sIZE]， 我 们 把 它 称 为 就 绪 优先 级 位 映像 表 ， 其 结构 如 表 12-1 所 示 。 这 个 就 绪 优先 级 位 映像 
表 用 于 存放 所 有 优先 级 就 绪 的 状态 ， 表 中 的 每 个 位 代表 一 个 优先 级 ， 比 如 OSsPrioTbl[0] 的 31 位 代表 的 就 是 优先 级 为 0 的 任务 就 绪 的 状态 。 如 果 该 位 为 
1， 表 示 该 优先 级 上 有 处 于 就 绪 状态 的 任务 ，0 则 表示 没有 。 注 意 ，hC/OS- 员 可 允许 多 个 任务 处 于 同一 优先 级 。 数 组 OSPrioTbl[OS_PRIO_TBL_ SIZE] 
和 OS_PRIO_TBL_SIZE 的 宏 定义 如 下 。 


CPU DATA 





有 OSPrioTbl[OS_PRIO_TBL SIZE]; 
#define OS PRIO TBL SIZE (((OS CFG PRIO MAX - 1u) / DEF INT CPU NBR BITS) + 1u) 












OSPrioTbl[0] 





表 12-1 


先 级 0 





OSPrioTbl[1] 


优先 级 32 


32 位 CPU 的 就 绪 优 先 级 位 映像 表 


优先 级 30 
优先 级 62 











优先 级 31 
优先 级 63 














OSPrioTbl[OS_PRIO TBL SIZE] 




















例 程 中 的 CPU_DATA 是 32 位 无 符号 数据 类 型 ， 所 以 一 个 元 素 包 含 32 个 优先 级 的 就 绪 状 态 。 宏 DEF_INT_CPU_NBR_BITS 表 示 的 数值 也 是 32.。 
OS_CFG_PRIO_MAX 是 设置 最 大 的 优先 级 个 数 ， 在 例 程 中 我 们 设置 为 64。 根 据 宏 定义 的 内 容 计算 OS_PRIO_TBL_SIZE 可 以 知道 在 例 程 中 这 个 值 是 2。 








意味 着 只 要 2 个 32 位 元 素 的 数组 就 可 以 表示 64 个 优先 级 上 的 任务 的 就 绪 状 态 。 


注意 : 这 里 的 就 绪 优 先 级 位 映像 表 是 32 位 CPU 的 。 如 果 不 是 32 位 的 CPU 只 是 每 个 元 素 的 位 数 不 一 样 ， 则 每 个 元 素 表 示 的 优先 级 个 数 也 不 一 样 ， 
后 面 介绍 的 实现 原理 都 一 样 。 


12.2 ”初始 化 就 绪 优 先 级 位 映像 表 


函数 Os_Priolnit 用 来 初始 化 就 绪 优先 级 位 映像 表 ， 其 源码 如 代码 清单 12-1 所 示 。 


代码 清单 12-1 ”就 绪 优先 级 位 映像 表 初 始 化 函数 Os_Priolnit 


voidq OS PrioInit (void) 
{ 


CPU DATA i; 


// 全 部 清 零 

for (i = 0uy i < OS PRIO TBL SIZE; i++) { 
OSPrioTb]1 [i] = (CPU DATA)O; 

} 


1 
4 
3 
4 
与 
6 
7 
8 
9 
20 3 


在 Oslnit 系 统 初始 化 函数 中 调用 了 OS_Priolnit 函 数 对 优先 级 进行 初始 化 ， 也 就 是 对 数组 OSPrioTbl[Os_PRIO_TBL_sIZE] 所 有 的 元 素 都 进行 清 零 
操作 。 这 表示 没有 任务 处 于 就 绪 状态 。 后 面 创建 任务 的 时 候 就 会 对 任务 优先 级 对 应 的 位 进行 置 1 操作 。 





12.3 ”查找 就 绪 优先 级 位 映像 表 中 最 高 的 优先 级 


在 进行 任务 切换 的 时 候 ， 首 先 要 查找 就 绪 列 表 中 优先 级 最 高 的 任务 ， 这 个 过 程 由 函数 OS_PrioGetHighest 来 完成 ， 其 源码 如 代码 清单 12-2 所 示 。 


代码 清单 12-2 ”查找 就 绪 优先 级 位 映像 表 中 最 高 优先 级 的 函数 ODS_PrioGetHighest 


} 
prio += (OS_ PRIO)CPU CntLeadZeros (*p tbl); 
return (prio); 


1 OS PRIO OS PrioGetHighest (void) 

2 { 

3 CPU DATA *p tbl; 

4 OS_PRIO prio; 

5 

6 

7 prio = (OS PRIO)O; 

8 p tbl = &OSPrioTb1[0]; 

9 while (*p tbl 一 (CPU DATA)0) { 
10 prio += DEF INT CEU NBR BITS; 
11 p_tbl+t+; 

12 
13 
14 
15 





函数 从 OSPrioTbl[0] 开 始 遍 历数 组 OSPrioTbl[OS_PRIO_TBL_SIZE] 中 的 所 有 元 素 ， 直 到 找到 非 零 的 元 素 。 为 什么 要 找到 非 零 的 元 素 呢 ? 前面 讲 过 
数组 OSPrioTbl[OS_PRIO_TBL_SIZE] 中 的 每 个 元 素 每 个 位 的 意义 。 如 果 OSPrioTbl[0] 不 为 零 ， 说 明 优 先 级 0~31 中 至 少 有 一 个 优先 级 有 就 绪 的 任务 ; 
如 果 为 零 ， 说 明 0~31 这 32 个 优先 级 的 任务 没有 一 个 是 就 绪 的 。 每 检查 一 个 元 素 人 遍历 的 就 是 32 个 优先 级 ， 就 将 优先 级 加 上 32。 然 后 继续 检查 下 一 个 元 
素 ， 最 后 肯定 会 有 非 零 的 元 素 存在 ， 因 为 空闲 任务 是 永远 就 绪 的 ， 空 闲 任务 对 应 的 优先 级 在 就 绪 优先 级 位 映像 表 相 应 的 位 肯定 是 非 零 的 。 为 什么 要 从 
第 一 个 元 素 开 始 查找 呢 ? 因为 我 们 是 要 查找 就 绪 列表 中 优先 级 最 高 的 任务 ， 前 面 的 元 素 优先 级 更 高 。 通 过 上 面 的 查找 ， 只 是 锁定 32 个 优先 级 中 至 少 有 
一 个 优先 级 有 就 绪 的 任务 。 接 着 继续 缩小 范围 ， 看 看 32 个 优先 级 中 有 就 绪 任务 且 优 先 级 最 高 的 是 哪个 。 结 合 表 12-1 中 就 绪 优先 级 位 映像 表 中 优先 级 
的 排列 顺序 可 以 将 问题 转化 为 : 在 32 位 的 变量 中 ， 从 最 高 位 开始 算 起 直到 第 一 个 非 零 位 之 间 有 多 少 个 零 。 假 设 数组 OSPrioTbl[OS_PRIO_TBL_SIZE] 
的 第 一 个 元 素 的 值 是 0x10000000， 从 最 高 位 开始 算 起 ， 到 第 一 个 非 零 之 间 有 3 个 零 ， 这 叫做 计算 前 导 零 个 数 。 这 个 3 代表 了 优先 级 2 (从 零 计数 ) 上 
有 任务 处 于 就 绪 状态 。 一 些 CPU 会 有 相应 的 指令 来 执行 这 种 计算 ， 比 如 使 用 的 内 核 Cortex-M3 就 提供 汇编 指令 CLZ 来 计算 。 第 13 行 调用 了 函数 

CPU _CntLeadZeros 来 计算 前 导 零 个 数 ， 函 数 CPU_CntLeadZeros 的 定义 如 代码 清单 12-3 所 示 。 




















代码 清单 12-3 ”调用 计算 前 导 零 的 指令 CLZ 


1 CPU_CntLeaq2eros 
2 CLZ RO, RO 
3 BX LR 


这 里 涉及 在 C 语 言 环境 调用 汇编 语言 的 知识 点 ， 具 体 将 在 后 面 章节 中 讲 到 。 这 里 只 要 简单 地 理解 为 调用 了 函数 CPU_CntLeadZeros， 执 行 了 CLZ 
指令 进行 计算 前 导 零 ， 最 后 将 结果 作为 参数 返回 。 


但 是 并 不 是 所 有 的 CPU 都 有 计算 前 导 零 的 指令 ， 如 果 有 定义 宏 CPU_CFG LEAD ZEROS ASM_PRESENT， 表 示 有 对 应 的 汇编 指令 ; 如 果 没 有 ， 
就 要 使 用 hC/OS- 咱 提供 的 C 语 言 同 名 函数 CPU_CntLeadZeros 进 行 前 导 零 的 个 数 的 计算 。 该 函数 包含 了 对 应 于 不 同位 数 的 CPU 不 同 的 操作 ， 但 是 思 
路 都 是 差不多 的 ， 这 里 以 32 位 CPU 为 例 进行 讲解 。 函 数 CPU_CntLeadZeros 的 具体 代码 如 代码 清单 12-4 所 示 。 








代码 清单 12-4 《语言 计算 前 导 零 个 数 














1 #ifndef CPU CEFG LEAD ZEROS ASM PRESENT 

2 CPU DATA CPU CntLeadZeros (CPU DATA val) 

3 

4 CPU_DATA nbr lead zeros; 

5 CPU INTO8U ix; 

6 

7 

8 #if (CPU CFG DATA SIZE == CPU WORD SIZE 08) 

9 

10 

11 ix = (CPU_INTO8U) (val >> 0u); 

12 nbr lead zeros = (CPU DATA ) (CPU CntLeadZzerosTbl[ix] + 0u); 

13 

14 

15 #elif (CPU CFG DATA SIZE == CPU WORD SIZE 16) 

16 if (val > Ox00FFU) { 

17 

18 ix = (CPU INT08U) (val >> 8u); 

19 nbr lead zeros = (CPU DATA ) (CPU CntLeadZzerosTbl[ix] + 0u); 
20 

21 } else { 

和 22 

23 ix = (CPU INT08U) (val >> 0u); 

24 nbr_ lead zeros = (CPU DATA ) (CPU CntLeadZerosTbl[ix] + 8u); 
25 } 

26 

27 

28 #elif (CPU CFG DATA SIZE == CPU WORD SIZE 32) 

29 if (val > Ox0000FFFFU) { 

30 if (val > OxOOFFFFFFU) { 

31 

32 ix = (CPU INT08U) (val >> 24u); 

33 nbr lead zeros = (CPU DATA ) (CPU CntLeadZerosTbl[ix] + 0u); 
34 

35 } else { 

36 

37 ix = (CPU INTO8U) (val >> 16u); 

38 nbr_ lead zeros = (CPU DATA ) (CPU CntLeadZerosTbl[ix] + 8u); 
39 } 

40 

41 } else { 

42 if (val > 0x000000FFu) { 

43 

44 1 = (CPU INTO8U) (val >> 8u); 

45 nbr lead zeros = (CPU DATA ) (CPU CntLeadZerosTbl[ix] + 16u); 
46 

47 } else { 

48 

49 ix = (CPU INTO8U) (val >> 0u); 

50 nbr lead zeros = (CPU DATA ) (CPU CntLeadZerosTbl[ix] + 24u); 
5 | 

52 } 

53 

54 

55 #elif (CPU CFG DATA SIZE == CPU WORD SIZE 64) 

56 if (val > Ox00000000FFFFFFFFU) { 

57 if (val > Ox0O000FFFFFFFFFFFFU) { 

58 if (val > OxOO0FFFFFFFFFFFFFFU) { 

9 

60 ix = (CPU INT08U) (val >> 56u); 

61 nbr lead zeros = (CPU DATA ) (CPU CntLeadZzerosTbl[ix] + 0u); 
62 

63 } else { 

64 

65 ix = (CPU INT08U) (val >> 48u); 

66 nbr lead zeros = (CPU DATA ) (CPU CntLeadZzerosTbl[ix] + 8u); 
67 } 

68 

69 } else { 

70 if (val > 0x000000FFFFFFFFFFU) { 

3 下 

72 ix = (CPU_INTO8U) (val >> 40u); 

73 nbr lead zeros = (CPU DATA ) (CPU CntLeadZzerosTbl[ix] + 16u); 
74 

75 } else { 


3 人 ix 

78 nbr lead zeros 
49 } 

80 } 

81 

82 } else { 

83 if (val > Ox000000000000FFFFU) { 

84 if (val > Ox0000000000FFFFFFU) { 
85 

86 ix 

87 nbr lead zeros 
88 

89 } else { 

90 

9 ix 

92 nbr_ lead zeros 
93 } 

94 

95. } :Else 

96 if (val > 0x00000000000000FFu) { 
97 

98 ix 

399 nbr lead zeros 
100 RE 
101 } else { 

102 

103 ix 

104 nbr lead zeros 
105 } 

106 } 

107 } 

108 

109 

110 #else 

Te] (void) &ix; 

112 nbr lead zeros = Ou; 
113 #endif 

114 

115 return (nbr lead zeros); 
116 } 

117 #engif 


(CPU_INTO8U) (val >> 32u); 
(CPU DATA ) (CPU CntLeadZerosTbl [ix] + 24u); 


(CPU INT08U) (val >> 24u); 
(CPU DATA ) (CPU CntLeadZerosTbl[ix] + 32u); 


(CPU INTO8U) (val >> 16u); 
(CPU DATA ) (CPU CntLeadZerosTbl [ix] + 40u); 


(CEU_ INTO8U) (val >> 8u); 
(CPU DATA ) (CPU CntLeadZzerosTbl [ix] + 48u); 


(CPU_INTO8U) (val >> 0u); 
(CPU DATA ) (CPU CntLeadZzerosTbl[ix] + 56u); 





函数 CPU_CntLeadZeros 的 整体 思路 是 无 论 先 分 离 成 几 个 8 位 (比如 32 位 CPU 就 分 为 0~7、8~15、16~23、24~31) ， 先 看 第 一 个 非 零 位 在 哪个 
区 间 。 通 过 与 0x00FFFFFF、0x0000FFFF、0x000000FF 比 较 即 可 知道 : 如 果 想 确定 第 一 个 非 零 位 是 否 在 高 8 位 中 ， 则 将 这 个 数 跟 0x00FFFFFF 一 起 比 
较 大 小 即 可 。 第 一 个 非 零 位 如 果 存 在 于 高 8 位 中 ， 那 么 这 个 数 一 定 大 于 0x00FFFFFF; 否则 第 一 个 非 零 位 肯定 不 存在 高 8 位 。 依 此 类 推 即 可 确定 第 一 个 
非 零 位 在 上 述 哪个 区 间 。 


知道 第 一 个 非 零 位 在 哪个 区 间 内 后 ， 取 出 其 8 位 数据 ， 接 着 通过 查 表 得 到 8 位 数据 的 前 导 零 个 数 ， 表 的 内 容 如 下 。 


1 #ifndef CPU CFG LEAD ZEROS ASM PRESENT 
2 static const CPU INTO8U CPU CntLeadZerosTb1[256] = { 
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二 3 于 
20 # 
只 有 理解 了 前 导 零 ， 才 能 明白 这 个 表 中 的 数据 为 什么 是 这 样 的 。 表 中 元 素 内 容 为 0， 表 示 前 导 零 的 个 数 是 0。 前 导 零 的 个 数 为 0 的 八 位 数据 是 什么 
样 的 呢 ? 就 是 1??????? (B) ， 即 第 一 个 数据 为 1， 后 面 位 为 0 或 1 都 有 可 能 。 这 样 的 数 有 多 少 个 呢 ? 由 数学 中 的 乘法 原理 可 知 2^7 个 ， 而 且 是 从 元 素 
CPU_CntLeadZerosTbl[128] 到 CPU_CntLeadZerosTbl[257]， 所 以 元 素 CPU_CntLeadZerosTbl[128]~CPU_CntLeadZerosTbl[257] 的 内 容 都 是 0。 
如 果 前 导 零 的 个 数 为 1， 那 么 八 位 数据 就 是 01?????? (B) 。 这 样 的 数据 有 多 少 个 呢 ? 同样 由 乘法 原理 得 到 2^6 个 ， 所 以 元 素 从 
CPU_CntLeadZerosTbl[127]~CPU_CntLeadZerosTbl[64] 都 是 1。 数 组 中 的 其 他 元 素 也 是 一 样 的 道理 


求 出 八 位 数据 中 前 导 零 的 个 数 后 ， 还 得 根据 前 面 判别 的 区 间 来 加 上 一 定 的 偏 移 量 。 比 如 32 位 数据 0x00010000， 开 始 根据 1 所 在 的 区 间 是 第 
16~23 位 取出 8 位 数据 0x01， 查 表 知 道 数据 0x01 前 导 零 的 个 数 是 7， 显 然 7 并 不 是 数据 0x00010000 前 导 零 的 个 数 ，15 才 是 ， 即 还 要 加 上 最 高 位 的 8 个 
前 导 零 。 同 理 8~15 位 的 要 加 上 16 的 偏 移 量 ，0~ 7 位 要 加 上 24 的 偏 移 量 。 











由 


综 上 所 述 ， 如 果 CPU 内 核 中 存在 现成 的 计算 前 导 零 的 指令 ， 那 么 整个 过 程 会 简单 很 多 ， 也 节省 了 查找 数据 所 占用 的 空间 。 


12.4 置 就 绪 优 先 级 位 映像 表 中 某 个 优先 级 处 于 就 绪 状 态 





有 些 读者 看 着 小 标题 愤愤 地 说 : “这 个 小 标题 怎么 这 么 长 ? 不 就 是 要 表达 把 就 绪 优 先 级 位 映像 表 相 应 位 置 1 的 操作 吗 ? ”这些 读者 说 得 对 ， 函 数 
Os_Priolnsert 的 功能 是 置 就 绪 优先 级 位 映像 表 中 某 个 优先 级 处 于 就 绪 状态 ， 其 实 就 是 把 就 绪 优先 级 位 映像 表 的 相应 位 置 1。 前 面 已 经 讲解 过 就 绪 优先 
级 位 映像 表 的 数据 结构 ， 每 32 个 优先 级 存放 在 32 位 CPU 的 一 个 数组 元 素 中 。 要 想 执行 把 就 绪 优先 级 位 映像 表 相 应 位 置 1 这 样 的 操作 ， 只 要 找 出 优先 级 
对 应 的 位 是 数组 OSPrioTbl[Os_PRIO_TBL_SsIZE] 中 的 哪个 元 素 和 这 个 元 素 对 应 的 位 ， 然 后 将 这 个 位 置 1 即 可 。 函 数 Os_Priolnsert 的 具体 代码 如 代码 清 
单 12-5 所 示 。 





代码 清单 12-5 ” 置 就 绪 优先 级 位 映像 表 中 某 个 优先 级 处 于 就 绪 状态 函数 Os_Priolnsert 


1 voidq OS PrioInsert (OS PRIO prio) 

2 { 

3 CPU DATA bit; 

4 CPU DATA bit nbr; 

5 OS PRIO ix) 

6 

7 

8 ix = prio / DEF INT CPU NBR BITS; 

9 bit npr = (CPU DATA)Prio & (DEF INT CPU NBR BITS - 1u); 
10 bit = 1u; 

11 bit <<= (DEF INT CPU NBR BITS - 1u) - bit nbr; 
12 OSPrioTbl [ix] |= bit; 


第 8 行 是 先 算出 优先 级 对 应 的 位 在 哪个 元 素 中 ， 宏 DEF_INT_CPU_NBR_BITS 的 大 小 是 32。 第 9 行 是 将 优先 级 限制 在 31 及 以 
内 ，DEF_INT CPU_NBR_BITS-1u=32-1=31=00001111 (B) ， 任 何 大 于 31 的 优先 级 与 00001111 (B) 进行 与 操作 后 ， 高 4 位 都 变 成 0， 所 以 肯定 小 
于 32。 比 如 优先 级 为 32 的 计算 得 出 的 bit_nbr 是 0，33 计 算出 来 是 1。 计 算出 来 的 bit_nbr 还 不 是 元 素 中 应 该 置 的 位 。 比 如 优先 级 为 33 的 时 候 应 该 将 
OSPrioTbl[1] 的 第 30 位 置 1， 而 计算 出 来 的 bit_nbr 是 1， 所 以 在 11 行 做 出 相应 的 调整 后 将 单独 将 该 位 置 1。 最 后 对 相应 的 元 素 对 应 的 位 置 1。 


12.5 ”将 就 绪 优先 级 位 映像 表 相应 位 清 0 
代码 清单 12-6 中 的 函数 OS_PrioRemove 用 来 将 就 结 优先 级 位 映像 表 相 应 位 清 0。 对 比 函数 5_Prioinsert， 只 有 最 后 一 句 不 一 样 ， 其 他 的 都 一 
样 


代码 清单 12-6 ”12.5 将 就 绪 优先 级 位 映像 表 相应 位 清 0 函数 OS_PrioRemove 


1 voidq OS PrioRemove (OS PRIO prio) 

2 { 

3 CPU DATA bit; 

4 CPU DATA bit nbr; 

5 OS PRIO ix; 

6 

7 

8 ix = prio / DEF INT CPU NBR BITS; 

9 bit nbr = (CPU DATA)Prio & (DEF INT CPU NBR BITS - 1u); 
10 bit = 1u; 

11 bit <<= (DEF INT CPU NBR BITS - 1u) - bit nbr; 
> OSPrioTbl [ix] &= ~bit; 


13° 





12.6 忆 结 


HC/OS-llI 巧 妙 地 构造 了 就 绪 优 先 级 位 映像 表 数 据 结构 ， 能 够 快速 找到 就 绪 列 表 中 最 高 优先 级 的 任务 ， 这 在 频繁 的 任务 切换 中 是 比较 重要 的 。 要 
清楚 地 知道 就 绪 优 先 级 位 映像 表 的 结构 及 其 意义 ， 才 可 以 理解 为 什么 要 计算 前 导 零 ， 以 及 怎么 置 就 绪 优 先 级 位 映像 表 中 的 位 使 任务 处 于 就 绪 状 态 。 


第 13 章 ” 束 绪 列表 


第 12 章 介绍 了 就 绪 优 先 级 位 映像 表 上 只 能 反映 优先 级 是 否 有 任务 就 绪 ， 而 uC/OS-lll 构 造 了 就 绪 列 表 来 进一步 管理 同一 个 优先 级 上 就 绪 的 多 个 任 
务 。 就 绪 列 表 有 点 像 等 待 列 表 ， 只 是 等 待 列表 的 用 途 是 管理 等 待 同一 个 内 核对 象 的 多 个 任务 ， 而 就 绪 列 表 是 管理 就 绪 任 务 。 


13.1 ”就绪 列表 数据 结构 解析 


HC/OS- 册 定义 了 一 个 数组 OSRdyList[Os_ CFG_PRIO_MAX]， 每 个 优先 级 对 应 其 中 的 一 个 元 素 ， 比 如 优先 级 为 0， 对 应 数组 元 素 OSRdyList[0]。 
数组 元 素 的 类 型 是 结构 体 类 型 OS RDY_LIST， 其 定义 如 图 13-1 所 示 。 


OS RDY LIST 
HeadPtr 
OSRdyLi1st[N| TailPtr 


NbrEntnes 





图 13-1 ”结构 体 类 型 OS_RDY_LIST 图 示 





结构 体 类 型 OS RDY_LIST 主 要 包含 以 下 三 个 元 素 。 
1) HeadPtr: 指向 对 应 优先 级 上 的 第 一 个 任务 控制 块 。 
2) TailPtr: 指向 对 应 优先 级 上 的 最 后 一 个 任务 控制 块 。 
3) NbrEntries: 记录 该 优先 级 上 有 多 少 个 任务 。 


相对 等 待 列 表 ， 就 绪 列表 比较 简单 ， 如 图 13-2 所 示 。 每 个 优先 级 对 应 一 个 双向 链表 ， 任 务 控制 块 的 元 素 NextPtr 和 PrevPtr 将 彼此 串 成 双向 链表 。 
执行 任务 时 ， 当 最 高 优先 级 上 有 多 个 就 绪 任务 的 时 候 ， 执 行 的 顺序 是 从 对 应 双向 链表 的 头 到 尾 。 
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图 13-2 ”就 绪 列 表 





13.2 ”初始 化 就 绪 列 表 


函数 OS_RdyListInit 用 来 初始 化 就 绪 列 表 ， 具 体 代码 如 代码 清单 13-1 所 示 。 


代码 清单 13-1 就绪 列表 初始 化 函数 OS_RdyListinit 





void OS RdyListInit (void) 
{ 


I 
OS RDY LIST *p rdy list; 





a 
多 
3 OS_PRIO 
4 
5 


for (i = Ou; i < OS CFG PRIO MAX; i++) { 
Pp rdy list = &OSRAdyList [i]; 


10 Pp rdy list->NbrEntries = (OS OBJ QTY)O0; 
11 P_rqy list->HeadPtr = (OS TCB *)0; 
12 p rdy ist->TailPtr = (OS_TCB wos 
13 } 

14 } 


OS_RdyListinit 函 数 在 系统 初始 化 函数 OSInit 中 被 调用 ， 主 要 用 于 遍历 数组 OSRdyList， 将 其 中 的 元 素 都 清空 


13.3 ”使 任务 就 绪 


函数 OS_RdyListlnit 用 来 使 任务 就 绪 ， 具 体 代码 如 代码 清单 13-2 所 示 。 


代码 清单 13-2 ”任务 就 绪 函 数 OS_RdyListlnit 


voidq OS RdyListInsert (OS TCB *p tcb) 
{ 


1 
2 
je OS_ PrioInsert (p tcb->Prio); 
4 站 (P_tcb->Prio == OSPrioCur) { 
与 OS RdyListInsertTail (p tcb); 
6 } else { 

J OS RAdyListInsertHead (p tcb); 
8 } 

9 } 


前 面 已 经 多 次 提 到 将 任务 插入 就 绪 列 表 这 种 操作 ， 比 如 当 处 于 等 待 状态 的 任务 获取 到 信号 量 或 任务 延 时 时 间 到 的 时 候 。 前 面 说 过 ， 管 理 就 绪 列 表 
不 仅 有 就 绪 列 表 还 有 就 绪 优先 级 位 映像 表 。 就 绪 优先 级 位 映像 表 用 于 确定 哪个 优先 级 上 有 就 绪 任务 ， 就 绪 列 表 用 于 确定 优先 级 上 具体 的 就 绪 任务 ， 两 
者 一 起 使 用 可 达到 快速 查找 优先 级 比较 高 的 就 绪 任务 。 函 数 OS_RdyListinsert 的 作用 是 让 任务 处 于 就 绪 状 态 ， 就 绪 列表 和 就 绪 优先 级 位 映像 表 要 一 起 
更 新 。 





第 3 行 对 插入 任务 的 优先 级 在 就 绪 优先 级 位 映像 表 中 对 应 的 位 置 1。 


第 4~ 8 行 根据 任务 优先 级 来 判断 将 任务 插入 就 绪 列 表 中 双向 链表 的 前 面 还 是 后 面 。 如 果 插 入 任务 的 优先 级 跟 当前 一 样 ， 那 么 将 其 插入 双向 链表 的 
最 后 ， 因 为 没有 任何 理由 要 当前 运行 任务 让 出 CPU 使 用 权 给 新 插入 的 任务 ;如 果 插 入 任务 的 优先 级 跟 当 前 任务 不 是 同一 个 优先 级 ， 就 插入 双向 链表 的 
头 部 。 上 述 操作 对 应 的 函数 如 代码 清单 13-3 和 代码 清单 13-4 所 示 。 


代码 清单 13-3 ”将 任务 控制 块 插 入 就 绪 列 表 对 应 双向 链表 的 前 面 








1 voidq OS RdqyListInsertHeaq (OS TCB *p tcb) 
2 
OS RDY LIST *p rdy list; 
4 OS_TCB *p tcb2; 
号 
6 
7 
8 p rdy list = &OSRdyList[p tcb->Prio]; 
9 if (p rdy list->NbrEntries == (OS OBJ QTY)0) { 
10 p_ rdy list->NbrEntries = (OS OBJ ( 人 Yi 
二 下 p_tcb->NextPtr = (8 TCB  *)0; 
12 p_tcb->PrevPtr = (OS_TCB *y0y 
13 p_rdy list->HeadPtr = Pteb 
14 Pp rdy list->TailPtr = ptcb 
二 二 } else { 
16 Pp rdy list->NbrEntriest++; 
17 Pp_tcb->NextPtr = p rdy list->HeadPtr; 
18 P tcb->PreVPtT = (OS_TCB #0 
19 p_tcb2 = rdy . list->HeadPtr; 
20 p_tcb2->PrevPtr = P tcb; 
21 p_rdy list->HeagdPtr = p tcb 
22 } 
3 


代码 清单 13-4 ”将 任务 控制 块 插入 就 绪 列 表 对 应 的 双向 链表 的 后 面 


voidq OS RdyListInsertTail (OS TCB *p tcb) 
{ 


ll 

2 

3 OS RDY LIST *p rdy list; 
4 OS _TCB *p tcb2; 





p rdy list = &OSRdyList[p tcb->Prio]; 


if (p rdy list->NbrEntries == (OS OBJ QTY)0) { 
Pp rdy list->NorEntries = (OS OBJ QTY)1; 
p_tcb->NextPtr = (OS TCB *)0y 
ptcb->PrevPtr = (O08. TCB x 
p_rdy list->HeadPtr = 了 cb 
p rdy list->TailPtr = p tcb 


} else { 
Pp rdy list->NbrEntriest+t+; 


p_tcb->NextPtr (OS TCB  *)0; 


Om~IOUPOWNPOOONO 





P_tcb2 三 Pp rdy list—>TailPtr; 
Pp_tcb->PrevPtr = p_tcb2 

20 p_tcb2->NextPtr = pp: teb; 

21 Bb rody list->TailPtr sp: tob 

22 } 

23 } 


前 面 我 们 已 经 见 过 各 种 列表 中 的 双向 链表 及 其 操作 ， 现 在 来 理解 代码 清单 13-3 和 代码 清单 13-4 的 函数 OS_RdyListinsertHead 和 
OS_RdyListlnsertTail 应 该 不 难 。 


13.4 将 任务 从 就 绪 列表 对 应 的 双向 链表 的 前 面 转移 到 后 面 
函数 0S_RdyListMoveHeadToTail 用 来 将 任务 从 就 绪 列 表 对 应 的 双向 链表 的 前 面 转移 到 后 面 ， 这 在 时 间 片 轮转 调度 中 是 非常 有 用 的 ， 具 体 代码 见 


代码 清单 13-5。 


代码 清单 13-5 ”将 任务 从 就 绪 列 表 双 向 链表 的 前 面 转移 到 后 面 的 函数 OS_RdyListMoveHeadToTail 








1 voidq OS RdyListMoveHeadToTail (OS RDY LIST *p rdy list) 
2 { 
3 OS TeCB *p tebl; 
4 OS TCB *p tcb2; 
5 OS TCB *p tcb3; 
6 
了 
8 
9 Switch (p rdy list->NbrEntries) { 
10 case 0: 
4 Case 1: 
12 break 
13 
14 case 2: 
15 P_tcb1 = p rdy list->HeadPtr; 
16 P_tcb2 = p rdy list->TailPptr; 
17 p_tcbl->PrevPtr = p tcb2; 
18 p_tcbl->NextPtr = (OS TCB *)0; 
19 p tcb2—>PrevPtr = (OS TCB *)0; 
20 p_tcb2->NextPtr = p tebl; 
21 p_rdy list->HeadPtr = p tcb2; 
22 p_ rdy list->TailPtr = p tcbl; 
23 break; 
24 
25 defauilt: 
26 Pp_tcbl = p rdy list->HeadPtr; 
27 p_tcb2 = dy Lis -SPTatlPer,; 
28 BE tos3 = p tcbl->NextPtr; 
29 5B teba>PrevPtr = (0S. TOB NO 
3 P tcbl->NextPtr = OS TEB oO 
31 Pp_tcbl->PrevPtr = PB tcb2; 
32 Pp_tcb2->NextPtr = p tcbl; 
33 P_rqy list->HeadPtr = p tcb3; 
34 p_rdy list->TailPtr = p tcbl; 
35 break; 
36 } 
37 1} 


在 讲解 函数 OS_RdyListMoveHeadToTail 之 前 ， 首 先 介绍 下 时 间 片 轮转 调度 。 在 一 个 优先 级 上 有 多 个 任务 ， 如 果 没 有 时 间 片 轮转 调度 ， 则 最 高 优 
先 级 双向 链表 最 前 面 的 任务 会 一 直 执行 ， 直 到 有 更 高 优先 级 的 任务 就 绪 。 这 个 过 程 中 的 最 高 优先 级 双向 链表 的 其 他 任务 不 能 获得 CPU 的 使 用 权 ， 除 非 
双向 链表 最 前 面 的 任务 放弃 了 CPU 的 使 用 权 ， 比 如 在 信号 量 不 可 用 的 时 候 调 用 信号 量 等 待 函 数 。 如 果 启 用 时 间 片 轮转 调度 ， 同 一 个 优先 级 上 的 多 个 任 
务 可 以 轮流 占用 CPU。 具 体 请 参阅 15.4 节 。 


当 启用 时 间 片 的 时 候 ， 一 个 任务 用 完了 时 间 片 ， 让 出 时 间 片 的 时 候 调 用 函数 OS_RdyListMoveHeadToTail 将 当前 任务 移 到 双向 链表 的 后 面 ， 让 同 
一 优先 级 的 其 他 任务 占用 CPU。 


当 任 务 的 优先 级 上 没有 任务 或 者 只 有 一 个 任务 的 时 候 不 用 进行 任何 调整 。 


当 任 务 的 优先 级 上 有 两 个 任务 的 时 候 ， 第 15~ 16 行 首先 取出 要 进行 交换 的 两 个 任务 。 第 17~20 行 用 于 调整 两 个 任务 的 指针 ， 调 整 后 的 结果 就 是 原 
来 为 第 一 个 的 任务 现在 变 成 了 最 后 一 个 ， 原 来 是 最 后 一 个 的 任务 现在 变 成 了 第 一 个 ， 这 样 要 调整 的 指针 就 很 明了 。 第 一 个 变 成 最 后 一 个 ， 作 为 最 后 一 
个 任务 的 元 素 NextPtr 指 向 的 就 是 0，PrevPtr 指 向 的 是 上 一 个 。 最 后 一 个 变 成 第 一 个 ， 将 元 素 NextPtr 指 向 下 一 个 任务 ，PrevPtr 指 向 0。 最 后 调整 双 
向 链表 指向 第 一 个 和 最 后 一 个 的 指针 HeadPtr、TailPtr。 当 任务 的 优先 级 上 有 两 个 以 上 任务 的 时 候 ， 操 作 也 是 类 似 的 。 


13.5 忆 结 


/GAN2 口 





本 章 首先 介绍 了 就 绪 列表 的 数据 结构 ， 接 着 介绍 了 就 绪 任务 插入 和 脱离 就 绪 列表 的 过 程 ， 最 后 介绍 了 在 时 间 片 轮转 调度 时 就 绪 列 表 的 相关 操作 。 
就 绪 列 表 的 数据 结构 其 实 很 好 理解 ， 因 为 一 个 优先 级 上 有 多 个 任务 需要 管理 ， 所 以 就 有 了 就 绪 列表 。 就 绪 列表 中 每 个 优先 级 的 任务 串 成 一 条 双向 链 
表 。 任 务 就 绪 的 时 候 就 要 将 其 插入 对 应 优先 级 的 双向 链表 中 去 。 如 果 任 务 不 再 就 绪 ， 就 将 其 从 对 应 的 优先 级 双向 链表 中 移 除 ， 其 实 就 是 双向 链表 的 操 
作 。 在 时 间 片 轮转 调度 的 时 候 ， 要 将 一 个 优先 级 上 的 就 绪 任 务 的 位 置 进行 调整 ， 抽 象 起 来 就 是 双向 链表 中 节点 的 移动 。 


第 14 章 ”任务 切换 


可 以 说 ，hC/OS-lll 中 最 神秘 的 部 分 莫 过 于 任务 切换 。 任 务 切换 的 过 程 很 简单 ， 首 先 保存 当前 任务 寄存 器 的 内 容 到 当前 任务 的 堆栈 ; 接着 弹出 即 
将 进行 的 任务 的 堆栈 内 容 ， 这 个 过 程 称 为 上 下 文 切 换 ; 最 后 继续 运行 切换 的 任务 。 这 些 过 程 真正 实施 起 来 还 需要 注意 很 多 问题 ， 如 有 具体 怎么 入 栈 和 出 
栈 、 寡 存 器 出 栈 跟 入 栈 的 顺序 等 。 学 习 时 可 以 将 任务 切换 跟 中 断 进 行 对 比 。 中 断 也 是 打破 当前 正在 运行 的 程序 的 流程 ， 然 后 执行 中 断 服务 程序 后 返回 
原来 的 任务 。 后 面 讲解 任务 切换 的 很 多 知识 点 都 是 基于 Cortex-M3 内 核 的 ， 如 果 对 Cortex-M3 内 核 有 一 定 的 了 解 ， 则 会 对 本 章 的 内 容 有 更 深入 的 理 
解 。 





执行 任务 切换 主要 是 在 调用 系统 函数 的 时 候 。 比 如 调用 信号 量 等 待 函 数 OSSemPend 的 时 候 信号 量 计数 值 等 于 0， 就 要 将 当前 的 任务 置 于 等 待 状 
态 ， 让 优先 级 更 高 的 任务 占用 CPU。 这 时 会 进行 任务 调度 ， 这 些 都 是 通过 调用 任务 级 任务 调度 的 宏 OSSched() 实 现 的 。 除 此 之 外 ， 每 次 中 断 服务 程序 
执行 完成 后 调用 OSIntExit。OSIntExit 不 仅 对 中 断 嵌 套 层 数 减 1， 也 调用 宏 OSIntCtxSw0 进 行 中 断 级 任务 调度 。 因 为 在 中 断 中 可 能 有 更 高 优先 级 已 经 
就 绪 ， 这 时 要 让 最 高 优先 级 的 任务 占用 CPU， 所 以 这 时 可 能 也 要 进行 调度 。OSssched0 和 OslntCtxSw() 两 者 虽然 都 可 以 进行 任务 调度 ， 但 是 细节 方面 
是 不 同 的 。 本 章 以 OSSched0 为 主 进行 介绍 ， 接 着 讲解 两 者 的 区 别 。 








14.1 ”堆栈 的 基本 概念 


由 于 任务 切换 等 内 容 涉 及 堆栈 的 相关 知识 ， 所 以 本 节 先 结合 HC/OS- 员 的 相关 内 容 介绍 堆栈 。 


现在 的 堆栈 基本 上 指 的 都 是 栈 ， 但 堆 和 栈 实 际 是 两 个 不 同 的 概念 ， 这 里 只 介绍 栈 。 堆 栈 指 的 是 遵循 后 进 先 出 原则 的 一 块 内 存 空间 ， 因 堆栈 有 后 进 
先 出 的 特性 ， 所 以 堆栈 主要 有 以 下 几 个 用 途 。 


1) 传递 参数 (为 被 调用 函数 提供 参数 ) 。 
2) 保存 局 部 变量 。 
3) 在 系统 中 用 堆栈 保存 任务 的 状态 〈 例 如 各 个 寄存 器 的 值 ) 。 


HC/OS- 咱 中 每 个 任务 的 堆栈 需求 大 小 是 不 一 样 的 。 因 为 每 个 任务 中 该 套 调用 函数 的 层 数 不 同 ， 传 递 的 参数 等 也 不 同 ， 程 序 流程 一 般 都 是 不 确定 
的 ， 计 算 过 程 比较 复杂 ， 所 以 任务 需要 的 最 大 堆栈 也 不 好 确定 。 在 切换 任务 的 时 候 ， 需 要 将 当前 任务 使 用 到 的 一 些 寄存 器 入 栈 ， 也 就 是 保存 上 下 文 。 


下 次 执行 任务 的 时 候 再 重新 将 这 些 寄存 器 从 任务 堆栈 中 弹出 来 ， 继 续 执行 就 好 像 没 有 发 生 任何 事情 一 样 。 


其 实 堆栈 又 称 为 后 进 先 出 的 线性 表 。 前 面 7.4 节 讲解 的 消息 队列 如 果 是 LIFO， 那 么 仅 需要 OutPtr 一 个 指针 指向 队列 的 输出 端 即 可 管理 消息 队列 ， 
因为 队列 的 输出 端 和 输入 端 都 是 一 样 的 。 同 样 ， 需 要 唯一 的 一 个 指针 指向 堆栈 的 一 端 ， 这 就 是 堆栈 指针 SP。SP 指 向 堆栈 中 最 后 一 个 被 压 进 堆栈 的 地 
址 。 在 任务 切换 的 时 候 需要 保存 当前 的 SP 到 任务 的 堆栈 中 去 。 后 面 恢复 任务 弹 栈 的 时 候 才 知道 从 哪里 开始 弹 栈 。 


堆栈 在 内 存 中 的 增长 方向 有 的 是 从 高 到 低 ， 也 有 的 是 从 低 到 高 。STM32 单 片 机 堆栈 的 增长 方向 是 从 高 到 低 。 


在 前 后 台 系统 中 ， 程 序 运行 也 需要 堆栈 ， 用 途 见 上 文 。 在 程序 正式 运行 之 前 得 先 初始 化 堆栈 ， 堆 栈 的 初始 化 操作 都 在 启动 文件 中 ， 有 兴趣 的 读者 
可 以 分 析 下 STM32 的 启动 文件 。 


14.2 ”Cortex-M3 推 栈 


Cortex-M3 有 两 个 堆栈 指针 ， 即 主 堆栈 MSP 和 进程 堆栈 PSP。 在 逻辑 地 址 上 ， 它 们 都 是 R13， 但 在 同一 时 刻 只 能 有 其 中 一 个 作为 程序 的 堆栈 指 
针 。 这 种 一 个 逻辑 地 址 对 应 两 个 物理 寄存 器 的 情况 在 串口 外 设 也 同样 存在 。 很 多 串口 外 设 有 两 个 缓冲 区 TXBUFF 和 RXBUFF， 它 们 对 应 同一 个 地 址 ， 
但 是 在 读 的 时 候 是 RXBUFF， 写 的 时 候 是 TXBUFF。 在 handle 模 式 (handle 模 式 即 是 运行 异常 服务 程序 或 者 中 断 服务 程序 的 时 候 ) 下 只 能 用 MSP， 不 
能 用 PSP， 程 序 一 开始 默认 也 是 使 用 MSP。 因 此 如 果 程 序 没有 进行 两 个 堆栈 指针 的 切换 ， 那 么 程序 从 头 到 尾 都 是 MSP。STM32 跑 裸 机 的 时 候 一 般 都 
只 用 到 MSP。 在 不 是 handle 模 式 的 情况 下 ， 如 果 使 用 的 是 PSP， 那 么 等 handle 模 式 的 时 候 ，CPU 会 自动 切换 成 MSP。 


MSP 和 PSsP 两 个 堆栈 指针 切换 有 两 种 方法 ， 一 种 是 修改 CONTROL 寄 存 器 的 1 位 ， 设 置 情况 如 图 14-1 所 示 。 对 CONTROL 寄 存 器 的 1 位 写 0， 就 选 
择 堆 栈 MSP; 写 1， 就 选择 PSP。 





图 14-1 寄存 器 CONTROL 位 1 的 含义 


另 一 种 方法 是 在 异常 返回 时 ， 通 过 修改 寄存 器 LR 的 位 2 也 能 实现 模式 切换 。 寄 存 器 LR 在 调用 子 程序 的 时 候 用 来 保存 调用 之 前 的 下 一 条 指令 的 地 
址 ， 子 程序 返回 的 时 候 只 要 跳 转 到 LR 的 地 址 就 可 以 实现 程序 的 返回 。 执 行 异 常服 务 程序 之 前 ， 返 回 地 址 被 弹 入 当前 正在 使 用 的 堆栈 ， 可 能 是 PSP 也 可 
能 是 MSP。 异 常 返 回 的 时 候 CPU 自 动 进行 弹 栈 ， 进 入 异常 服务 程序 之 前 的 下 一 条 指令 的 地 址 又 保存 到 了 寄存 器 LR， 程 序 根据 LR 跳 转 回执 行 异常 之 前 
的 那个 地 方 继续 执行 。 执 行 异常 服务 程序 的 时 候 返 回 地 址 被 弹 入 栈 ， 那 么 在 执行 异常 服务 程序 的 时 候 是 否 LR 就 没有 作用 了 呢 ? 不 是 ， 在 一 开始 进入 
handle 模 式 的 时 候 ，LR 寄 存 器 被 自动 更 新 为 EXC_RETURN。EXC_RETURN 位 段 的 含义 如 图 14-2 所 示 。 


0= 返 回 后 进入 handler 模 式 
1= 返 回 后 进入 线程 模式 


1 | 保留， 必须 为 0 





图 14-2 EXC_RETURN 各 位 的 含义 


综 上 所 述 ， 不 难 理解 EXC_RETURN 只 有 图 14-3 中 的 3 个 合法 值 。 


EXC_RETURN ”功能 
数值 


OXxFFFF_FFF1 返回 handler 模 式 
OxFFFF_FFF9 述 回 线程 模式 ， 并 使 用 主 堆栈 (SP=MSP) 
OxFFFF_FFFD ”返回 线程 模式 ， 并 使 用 线程 堆栈 (SP=PSP) 


图 14-3 EXC_RETURN 的 合法 值 及 含义 





所 以 在 异常 返回 的 时 候 ， 如 果 我 们 将 LR 寄存 器 的 2 位 置 1 的 话 ， 异 常 返回 后 就 可 以 切换 到 PSP 了 。 


J 有 


需要 注意 的 是 ，hC/OS- 吊 中 任务 级 的 代码 使 用 的 堆栈 指针 是 PSP， 任 务 切换 的 过 程 是 在 异常 服务 程序 中 进行 的 ， 所 以 用 的 堆栈 指针 肯定 是 
MSP。 前 后 台 系 统 的 时 候 我 们 一 般 只 用 MSP 就 足够 了 上 ，hC/OS- 吊 用 了 两 个 堆栈 指针 ， 这 有 什么 好 处 呢 ? 后 面 将 结合 任务 切换 详 述 。 


Cortex-M3 的 堆栈 是 向 下 增长 的 ， 这 将 对 堆栈 的 具体 操作 有 影响 。 我 们 给 每 个 任务 分 配 了 一 定 的 内 存 作为 任务 的 堆栈 ， 这 有 段 堆栈 的 初始 化 ， 栈 底 
地 址 ， 堆 栈 检测 都 跟 堆栈 增长 方向 有 密切 联系 。 在 我 们 的 例 程 中 有 如 下 宏 定义 ， 方 便 hC/OS- 员 增加 可 移植 性 ， 只 要 修改 这 个 宏 即 可 适应 堆栈 增长 方 
向 不 同 的 各 种 CPU， 这 个 宏 会 影响 到 一 些 堆栈 操作 。 





#define CPU CFG STK GROWTH CPU STK GROWTH HI TO LO 








14.3 ”任务 切换 


函数 OSsched 的 功能 是 任务 切换 ， 代 码 清单 14-1 是 其 源码 。 


代码 清单 14-1 ”任务 切换 函数 OSSched 





1 void OSSched (void) 
2 { 
3 CPU SR ALLOC(); 
” a 
与 
6 // 还 在 中 断 中 ， 不 能 进行 任务 调度 
内 if (OSIntNestingCtr > (OS NESTING CTR) 0) { 
8 return; 
9 } 
向 
二 // 调度 器 锁 住 了 ， 不 能 进行 任务 调度 
12 if (OSSchedLockNestingCtr > (OS NESTING CTR)0) { 
13 return; 
14 } 
15 
16 // 关中 断 
17 CPU INT DIS () ; 
18 // 找 出 就 绪 列 表 中 优先 级 最 高 的 任务 的 优先 级 
19 OSPrioHighRdy = OS PrioGetHighest (); 
20 // 找到 该 优先 级 下 对 应 的 第 一 个 任务 
21 OSTCBHighRAyPtr = OSRdyList [OSPrioHighRdy] .HeadPtr; 
22 // 判断 该 任务 是 否 跟 当 前 运行 任务 是 一 样 的 
23 if (OSTCBHighRdyPtr == OSTCBCurPtr) { 
24 CPU_INT EN(); 
25 return; 
26 } 
27 


28 #if OS CFG TASK PROFILE EN > 0u 
29 //_ 被 切换 到 的 任务 的 切换 次 数 加 1 








30 OSTCBHighRdyPtr->CtxSwCtrt++; 
31 #enqif 

32 // 总 得 任务 切换 次 数 加 1 

33 OSTaskCtxSwCtr++; 

34 

35 // 调用 任务 切换 的 宏 

36 OS_TASK SW(); 

37 // 使 能 中 断 

38 CPU_INT EN(); 

39 } 


函数 OSsched 可 能 可 以 算是 “最 熟悉 的 陌生 人 ”了 ， 在 前 面 的 代码 分 析 中 ， 我 们 经 常 看 到 这 个 函数 却 只 知道 他 是 任务 切换 的 ， 对 它 其 他 的 方面 
一 无 所 知 。 


首先 如 果 是 在 中 断 中 或 者 调度 器 被 锁 住 ， 就 不 能 直接 进行 调度 直接 退出 。 中 断 的 代码 一 般 做 的 都 是 重要 并 且 比 较 简单 的 事情 ， 中 断 必须 先 执 行 完 
再 去 执行 任务 相关 代码 。 如 果 在 中 断 中 进行 任务 调度 ， 不 仅仅 会 影响 系统 的 实时 性 ， 中 断 服 务 程序 不 能 及 时 运行 ， 而 且 可 能 会 产生 异常 (关于 中 断 中 
进行 任务 切换 引发 的 异常 在 网 上 有 相关 的 文章 一 一 《破坏 STM32 中 断 机 制 引发 的 异常 》 进 行 分 析 ， 大 家 可 以 去 看 下 ) 。 根 据 前 面 的 第 12 章 第 13 章 关 
于 就 绪 列 表 的 知识 很 容易 就 找 出 就 绪 列表 中 哪 一 个 优先 级 最 高 ， 且 该 优先 级 哪个 任务 应 该 进行 切换 执行 ， 然 后 判断 该 任务 是 不 是 跟 当前 运行 任务 相 
同 。 如 果 相同 就 不 用 进行 调度 ， 如 果 不 同 先 对 任务 切换 的 次 数 OSTCBHighRdyPtr-> CtxSwCtr 跟 系统 总 的 任务 切换 的 次 数 OSTaskCtxSwCtr 进 行 更 
新 ， 接 着 执行 调度 ， 这 个 时 候 只 是 调用 了 宏 OS_TASK_SW0。 有 些 读者 可 能 会 想 ， 原 来 任务 切换 这 么 简单 ， 就 是 调用 了 一 个 宏 ， 看 似 简单 的 东西 其 实 
不 简单 ， 因 为 这 个 宏 只 是 相当 一 个 导 火 索 ， 后 面 会 “引爆 ”其 他 的 操作 。 


我 们 展开 宏 OS TASK_SW0 及 其 相关 的 一 些 宏 来 看 下 。 


#define OS TASK SW() NVIC _ INT CTRL = NVIC PENDSVSET 
#define NVIC INT CTRL *( (CPU REG32 *)O0xEO000EDO4) 
#define NVIC PENDSVSET 0x10000000 


通过 上 面 我 们 可 以 知道 宏 OS_TASK_SW0 实 际 上 就 是 把 CPU 地 址 为 0xXE000ED04 的 寄存 器 的 第 28 位 (从 0 位 开始 ) 置 1。 通 过 查找 STM32 的 数据 手 
册 我 们 可 以 查找 到 第 28 位 的 作用 如 图 14-4、 图 14-5 所 示 。 





31 30 29 28 27 26 25 24 23 22 21 12:11 10 9 8 


ee 加 | VECTPENDING Ni VECTACTIVE 
] ISRPENDING ] RESERVED 
ISRPREEMPT RETTOBASE 


PENDSTCLR 
PENDSTSET 
PENDSVCLR 


PENDSVSET 
NMIPENDSET 


图 14-4 PendSV 悬 起 位 所 在 寄存 器 


0 


[28] PENDSVSET Read/write Setpending pendSV bit: 
1 = set pending pendSV 


0 = do not set pending pendSY. 





图 14-5 ”地址 NVIC_INT_CTRL 各 个 位 的 含义 





我 们 知道 宏 OS_TASK_SW0 的 作用 就 是 悬 起 异常 PendSV (对 于 PendSV 的 更 多 详情 请 参见 《Cortex-M3 权 威 指南 》) 。 





就 是 可 悬 起 。 悬 起 即 是 在 当前 有 其 他 的 中 断 ， 并 且 PendsV 优 先 级 不 如 这 些 中 断 高 ， 那 么 PendSsV 的 服务 程序 会 “缓期 执行 


异常 PendSV 的 一 个 特点 
行 ”。 悬 起 异常 PendSV 的 时 


候 ， 如 果 没 有 比 异 常 PendSV 优 先 级 更 高 的 中 断 ，CPU 首 先 会 自动 将 当前 的 CPU 的 寄存 器 逐一 进行 弹 栈 ， 这 跟 中 断 一 开始 的 时 候 是 一 样 的 。 我 们 知道 
切换 的 第 一 步 一 一 入 栈 就 算 勉 强 搞定 了 。 为 什么 说 是 “勉强 ”? 因为 CPU 自动 入 栈 并 没有 把 堆栈 中 所 有 的 寄存 器 都 入 栈 ， 入 栈 的 寄存 器 如 图 14-6 所 





小 。 





六 SP (N-32) 


图 14-6 CPU 入 栈 的 寄存 器 及 顺序 


CPU 自动 入 栈 的 顺序 我 们 就 可 以 不 用 管 了 ，CPU 自 动 帮 有 我 们 入 栈 ， 我 们 主要 关注 的 地 方 是 CPU 没有 入 栈 的 寄存 器 R4~ R11。 这 些 寄存 器 有 没有 被 
保存 到 堆栈 中 去 ， 因 为 CPU 寄存 器 是 用 来 保存 当前 任务 的 一 些 变量 ， 中 间 结 果 。 我 们 之 所 以 要 将 寄存 器 入 栈 是 因为 怕 中 断 服 务 程序 会 将 这 些 寄存 器 的 


值 改变 。 如 果 在 异常 PendSV 中 使 用 了 R4~R11 这 些 寄 存 器 ， 那 么 程序 运行 就 出 错 了 ， 就 算 异常 PendSV 不 改变 这 些 寄存 器 ， 切 换 到 新 的 任务 后 ， 这 些 


寄存 器 也 有 可 能 被 改变 。 为 什么 CPU 不 将 所 有 的 寄存 器 都 入 栈 呢 ? 因为 中 断 服务 程序 一 般 来 说 是 比较 短小 精 悍 的 ， 所 以 一 般 来 说 CPU 自动 入 栈 的 那 几 
个 寄存 器 已 经 够 中 断 服 务 程序 使 用 ， 不 会 改变 到 R4~ R11 这 几 个 寄存 器 。 这 种 情况 CPU 不 将 R4~ R11 进 行 入 栈 是 没有 问题 的 。 如 果 中 断 服务 程序 比 


较 大 ， 必 须要 用 到 R4~ R11， 这 个 时 候 编译 器 会 检查 到 并 且 自 动 将 R4~R11 中 的 部 分 寄存 器 进行 入 栈 ， 并 且 在 退出 中 断 服 务 程序 的 时 候 将 这 些 寄存 器 
的 值 从 堆栈 中 弹 栈 出 来 。 





前 面 我 们 用 宏 OS_TASK_SW0 悬 起 了 异常 PendSV， 如 果 这 个 时 候 没有 更 高 优先 级 的 中 断 或 者 中 断 没有 被 屏 黄 ， 就 会 执行 PendSV 服 务 程序 。 
PendSV 服 务 程序 是 任务 切换 的 关键 ， 如 代码 清单 14-2 所 示 ， 全 部 是 汇编 编写 的 ， 不 熟悉 汇编 指令 的 可 以 参阅 下 《Cortex-M3 权 威 指南 》。 


代码 清单 14-2 ”异常 PendSV 服 务 程序 





1 OS CPU PendSVHandler 

2 ;关中 断 ， 防 止 执行 的 过 程 中 出 现 中 断 ，Cortex-M3 是 可 以 进行 中 断 谱 套 的 
3 CPSID I 

4 ; 读 取 PSP 的 值 到 RO 


5 ;如果 RO (PSP) 为 0， 即 第 一 次 进行 任务 切换 ， 直 接 跳 转 到 0OS_CPU PendSVHandler nosave 处 
6 MRS R0， PSP 

7 CBZ RO, OS CPU PendSVHandler nosave 

8 ;入 栈 之 前 首先 要 调整 堆栈 指针 的 位 置 ，R4~R11 一 共 8 个 寄存 器 ，32 个 字 节 ， 即 0x20 

9 SUBS RO, RO, #0x20 

10 ;将 R4~R11 一 共 8 个 寄存 器 的 内 容 运用 STM 指 令 一 次 性 搬移 到 堆栈 

11 STM RO, {R4-R11} 

12 ;3 个 语句 结合 将 RO 存放 的 内 容 当前 的 放 到 OSTCBCurPtr->StkPtr, 由 上 面 我 们 知道 RO 的 内 容 
13 ;是 R4~R11 入 栈 之 后 堆栈 指针 PSP 新 的 地 址 ,但 是 暂时 保存 在 RO 中 ， 没 有 更 新 到 PSP 中 去 。 


14 LDR R1, =OSTCBCurPtr 
15 LDR R1, [R1] 
16 STR RO, [R1] 


17 ;执行 任务 切换 时 候 的 回调 函数 0STaskSwHook 
18 OS_CPU_ PendSVHandler nosave 





























19 PUSH {R14} 

20 LDR RO, =OSTaskSwHook 

21 BLX RO 

22 POP {R14} 

23 ;相当 于 OSPrioCur = OSPrioHighRdy; 
24 LDR RO, =OSPrioCur 

25 LDR R1, =OSPrioHighRdy 
26 LDRB R2, [R1] 

27 STRB R2, [RO] 

28 ;相当 于 OSTCBCurPtr = OSTCBHighRdyPtr; 
29 LDR RO, =OSTCBCurPtr 

30 LDR R1, =OSTCBHighRAyPtr 
31 LDR R2， [R1] 

32 STR R2, [RO] 

33 ;将 新 的 任务 的 堆栈 进行 弹 栈 给 R4~R11 

34 LDR RO, [R2] 

35 LDM RO, {R4-R11} 

二 和 ADDS RO, RO, #0x20 

37; 将 RO 的 值 赋 给 PSP， 前 面 RO 一 直 代 替 PSP 进 行 弹 栈 和 入 栈 
38 MSR PSP, RO 

39; 确 保 EXC RETURN 的 2 位 为 1 

40 ORR LR, LR, #0x04 

41 CPSIE ;开启 中 断 

42 BX LR ”异常 返回 

43 END 





进入 PendSV 异 常服 务 程序 后 ， 因 为 在 运行 任务 的 时 候 ， 系 统 使 用 的 是 进程 堆栈 PSP， 所 以 进入 异常 服务 程序 的 时 候 CPU 会 自动 地 将 堆栈 指针 从 
PSP 切 换 到 MSP， 同 时 也 会 修改 CONTROL 寄 存 器 的 1 位 为 0 和 LR 寄存 器 的 值 为 EXC_RETURN， 更 新 PC、xPSR 中 的 异常 编号 等 。 详 情 请 观察 对 比 下 面 
在 进入 PendSV 异 常服 务 程序 前 后 的 两 幅 图 片 图 14-7 和 图 14-8， 图 中 稍微 标注 了 一 些 寄存 器 代表 的 合 义 ， 具 体 请 参考 《Cortex-M3 权 威 指南 》。 








358 oid OSSched (void) 任务 调度 函数 
CPU_SR_ALLOC() ; 
if (OSIntNestingCtr > (0S_NESTING CTR)O0) { 


return: 


if (OSSchedLockNestingCtr > (0S NESTING CTR)0) { 


return:; 


LR 寄存 器 还 不 是 EXC_RETURN 的 值 


CPU_INT_DISO : 
OSPrioHighRdy = 0S PrioGetHighest(): 
OSTCBHighRdyPtr = OSRdyList[O0SPrioHighRdy|]. HeadPtr: 
if (OSTCBHighRdyPtr == OSTCBCurPtr) { 

CPU _ INT_EN( : 


return: 


} 还 没有 进入 中 断 


0STCBHighRdyPtr->CtxSwCtr++: 
中 断 被 禁止 
系统 运行 任务 的 时 候 使 用 的 是 
OS_TASK-—SW 人 OO 进程 堆栈 PSP 
CPU _INT_FN() : 


程序 运行 到 这 里 ， 乔 常 PendSV 已 经 锌 总 起 


国 projed | 填 Registers (一 但 起 中 地 灶 洲 有 有 术 信 六 


OSTaskCtxSwCtr++- 





图 14-7 进入 PendSV 异 常服 务 程序 之 前 














Registers 





一 国 os cpu_aasm | 困 oscoresc “国有 


[136 0S_CPU PendSVHandler 吴兴 党 服 条 程序 

OO er CPSID I 

0x00000000 138 MRS RO; PSP 

ee 139 CBZ RO, OS_ CPU PendSVHandler nosave 

0x06060B06 140 

人 SUBS RO, RO, #0x20 

Dx00000000 STM {R4-R11} 

Ox10101010 | 
: es | LDR =0STCBCurPtr 
i | Tt LDR \ [R 1] 

| | » ee - 

人 | 5 LR 寄存 器 为 EXC_RETURN 的 
,pcr Ox0100000E 值 


0S_CPU PendSVHandler nosave 
PUSH {R14} 
LDR RO, =0STaskSwHook 
BLX | 
POP 


中 断 类 型 为 14， 即 PendSV 








于 LDR oC =0SPrioCur 
i - | LDR =O0SPrioHighRdy 

BASEPRI Ox00 | LDRB 2 [R1] 

ER STRB——R2;—tRO * 进入 异常 服务 之 前 中 断 被 
CONTROL Dx00 7 
自 IDR RO =0STCBCGiPt 
"EE TDR——— R1,，- =0STCBHighRdyPtr 


“Privilege Frivileged 


-EE MSF LDR R2，[R1] 避 进入 异常 服务 程序 后 使 
ES SIR。 R2，fRO] ”用 的 是 让 堆 入 WSP ， 


™ 





























图 14-8 PendSV 异 常服 务 程序 之 后 


前 面 讲 到 进行 中 断 服务 程序 的 时 候 编译 器 自动 判断 R4~R11 中 哪些 寄存 器 是 会 被 用 到 ， 然 后 将 其 入 栈 。 但 是 任务 切换 不 同 ， 我 们 除了 进入 异常 
PendSV 异 常服 务 程序 外 ， 还 会 切换 到 其 他 的 任务 执行 ， 之 后 进行 的 任务 几乎 一 定 会 运用 到 R4~R11 这 些 寄存 器 。 故 除去 第 一 次 任务 切换 之 外 (后面 
解释 ) 的 所 有 的 任务 切换 都 需要 将 R4~R11 进 行 入 栈 。 既 然 CPU 没 有 自动 保存 这 些 寄存 器 ， 我 们 应 该 自行 将 这 寄存 器 入 栈 ， 防 止 被 修改 。 代 码 清单 
14-3 的 8~11 行 就 是 将 R4~R11 入 栈 的 过 程 。 


将 R4~R11 入 栈 之 后 ， 我 们 还 必须 做 的 就 是 将 当前 的 堆栈 指针 放 到 OSTCBCurPtr- > StkPtr 中 去 。 下 次 我 们 要 重新 切换 回 这 个 任务 的 时 候 ， 根 据 任 
务 控制 块 的 元 素 StkPtr 的 值 我 们 就 知道 从 哪里 开始 弹 栈 了 。 注 意 StkPtr 位 于 任务 控制 块 的 第 一 个 元 素 ， 所 以 OSTCBCurPtr 和 和 StkPtr 的 地 址 是 一 样 的 ， 
这 是 uC/OS- 咱 作者 有 意 为 之 ， 方 便 操 作 。 


但 是 如 果 是 第 一 次 任务 切换 ， 所 有 任务 都 没有 执行 过 ， 是 从 没有 任务 到 有 任务 的 一 个 过 程 ， 那 么 RM~R11 中 就 没有 保存 任务 相关 的 信息 ， 所 以 不 
需要 保存 到 任务 的 堆栈 ， 也 不 需要 将 PSP 放 入 任务 的 堆栈 。 系 统 运行 之 前 ,我们 会 先 将 PSP 置 为 0%，STM32 程 序 开始 运行 用 的 都 是 MSP， 所 以 XC/OS- 
川 在 系统 开始 的 时 候 修改 PSP 为 0 作为 第 一 次 任务 切换 的 标志 。 


接着 执行 执行 任务 切换 时 候 的 回调 函数 OSTaskSwHook。 执 行 之 前 要 将 LR 寄 存 器 (保存 的 是 值 是 EXC_RETURN) 入 栈 ， 因 为 程序 调用 函数 之 前 
会 将 下 一 条 指令 的 地 方 放 在 LR 寄 存 器 中 。 如 果 不 这 样子 做 ，LR 寄 存 器 的 值 会 被 覆盖 ， 后 面 就 会 发 生 错误 。 接 着 跳 转 到 OSTaskHook 执 行 完毕 后 再 将 
LR 寄存 器 的 值 弹 出 。 


然后 更 新 当前 运行 任务 控制 块 指针 和 优先 级 ，23~32 行 相当 于 以 下 两 句 C 语 言 代码 。 





OSPrioCur = OSPrioHighRdy; 
OSTCBCurPtr = OSTCBHighRdyPtr; 





第 29 行 可 以 说 是 鬼 人 逢 神 工 ， 这 个 语句 虽然 简单 ， 但 其 影响 却 是 巨大 。 之 前 的 操作 中 ，R0 保 存 了 最 新 任务 的 堆栈 指针 PSP 的 地 址 (但 是 还 没有 更 新 
到 PSP 中 去 ) ，R2 保 存 了 就 绪 列 表 中 优先 级 最 高 的 任务 的 堆栈 指针 。 所 以 第 29 行 实际 就 是 将 优先 级 最 高 的 任务 之 前 保存 的 堆栈 指针 放 到 堆栈 指针 PSP 


中 去 。 


可 能 初学 者 可 能 还 体会 不 到 这 句 话 带 来 的 威力 ， 后 面 执行 就 全 面 展示 了 29 行 的 真正 威力 。33~36 行 将 R4~R11 等 寄存 器 从 堆栈 中 弹出 ， 注 意 这 时 
的 堆栈 已 经 是 新 切换 进来 的 任务 的 。 这 部 分 就 是 我 们 前 面 讲解 的 任务 切换 内 容 的 后 半 部 分 ， 从 新 的 任务 的 堆栈 中 弹 栈 。 


38 行 将 RO 的 值 赋 给 PSP， 之 前 RO 代替 PSP 行 使 堆栈 指针 的 任务 ， 现 在 将 新 的 堆栈 指针 的 地 址 赋 给 PSP。 


之 前 说 过 任务 运行 的 时 候 使 用 的 是 进行 堆栈 PSP， 我 们 又 知道 如 果 不 是 我 们 程序 的 设置 ，CPU 会 一 直 使 用 MSP， 所 以 退出 PendSV 异 常服 务 程序 
之 前 要 进行 设置 才 可 以 在 任务 中 使 用 PSP， 在 执行 异常 服务 程序 的 时 候 使 用 MSP。40 行 就 是 让 EXC_RETURN 的 2 位 置 1， 根 据 前 面 的 讲解 我 们 知道 ， 
这 意味 着 这 退出 中 断 服 务 程序 后 要 使 用 PSP。Cortex-M3 的 两 个 堆栈 指针 就 是 为 了 让 系统 内 核 和 任务 各 使 用 一 个 堆栈 ， 从 而 避免 系统 堆栈 因应 用 程序 
的 错误 使 用 而 毁坏 。 


42 行 就 是 从 异常 服务 程序 中 返回 。 有 些 读 者 可 能 会 感觉 有 点 奇怪 : 前 面 说 LR 寄 存 器 在 异常 服务 程序 中 存放 的 是 EXC_RETURN 的 值 ， 跳 转 到 这 个 
值 怎么 就 是 返回 ? 如 果 说 LR 寄存 器 存放 的 是 进入 异常 之 前 的 下 一 条 指令 ， 那 么 逻辑 上 还 说 得 通 。 在 《Cortex-M3 权 威 指南 》 中 有 讲解 到 异常 返回 的 
多 种 方式 ， 其 中 图 14-9 的 第 一 种 就 是 我 们 使 用 的 。 


返回 指令 工作 原理 
BX <reg> 当 LR 存 储 了 EXC_RETURN 时 ， 使 用 BX LR 即 可 返回 
POP {PC} 和 在 服务 例 程 中 ，LR 的 值 常 常会 被 压 入 栈 。 此 时 即 可 使 用 POP 指令 
把 LR 存 储 的 EXC_RETURN 往 PC 里 弹 ， 从 而 启动 处 理 器 的 中 断 返 回 
POP {...,PC} 
序列 
LDR 与 LDM 把 PC 作为 目的 寄存 器 ， 亦 可 启动 中 断 返 回 序列 


图 14-9 ”Cotex-M3 触 发 异常 返回 


异常 返回 的 时 人 息 CPU 会 自动 弹 栈 ， 将 xPSR，PC，LR，R12 以 及 R3-RO 按 照 正确 的 顺序 从 新 的 任务 中 弹出 ， 保 存 到 这 些 寄 存 器 中 去 。 到 这 里 为 
止 ,我 们 已 经 从 一 开始 的 保存 被 切换 掉 的 任务 的 寄存 器 到 逐步 将 新 的 任务 的 寄存 器 全 部 弹 栈 ， 其 中 包括 了 PC。PC 保 存 着 下 一 条 指令 的 地 址 ， 这 样子 
CPU 就 切换 到 了 新 的 任务 之 前 被 切换 的 时 候 的 那个 点 继续 执行 。 


以 上 就 是 任务 切换 的 全 部 过 程 了 ， 如 果 第 一 遍 看 不 懂 可 以 多 看 几 遍 ， 加 深 理 解 。 接 下 来 讲解 任务 切换 另外 的 一 些 细节 。 


14.5 ”首次 任务 调度 


函数 OSStartHighRdy 用 来 进行 首次 任务 调度 ， 首 次 任务 调度 主要 是 做 好 一 些 准备 工作 ， 其 源码 见 代码 清单 14-3。 


代码 清单 14-3 ”首次 任务 调度 函数 OSStartHighRdy 


1 OSStartHighRdy 

2 LDR RO, =NVIC SYSPRI14 
3 LDR R1, =NVIC PENDSV_ PRI 
4 STRB R1, [RO] 
5 ;将 PendSV 的 优先 级 置 为 最 低 
6 MOVS RO, #0 
7 MSR PSP, RO 
8 ;将 PSP 置 0 

9 LDR RO, =0S CPU ExceptStkBase 
10 LDR R1, [RO] 

11 MSR MSP, R1 

12 ;为 内 核 分 配 内 存 空间 

13 LDR RO, =NVIC INT CTRL 

14 LDR R1, =NVIC PENDSVSET 

15 STR R1, [RO] 

16 





17 CPSIE 1 


18 
19 OSStartHang 
20 B OSstartHang 





在 系统 初始 化 后 ， 我 们 就 在 OSStart 中 进行 第 一 次 任务 切换 ， 第 一 次 切换 之 前 还 需要 做 一 些 准 备 工作 。NVIC_SYSPRI14 代 表 的 是 
0xE000ED22，NVIC_PENDSV_PRI 代 表 的 是 0xFF。2~4 行 就 是 给 地 址 0xE000ED22 写 入 0xFF， 从 STM32 的 手册 可 以 查 到 图 14-10 所 示 的 表格 。 


所 以 上 述 语句 就 是 将 PendSV 优 先 级 置 为 最 低 ， 结 合 PendSV 可 以 悬 起 的 特点 ， 可 以 避免 在 中 断 进 行 任务 切换 (因为 PendSV 优 先 级 最 低 ， 不 能 打 


断 其 他 中 断 ) 并 且 在 中 断 的 最 后 一 定 会 进行 任务 切换 (在 执行 完 其 他 高 优先 级 中 断 的 时 候 如 果 PendSV 悬 起 则 会 执行 PendSV 服 务 程序 进行 任务 切 
换 ) 。 这 是 中 断 中 任务 切换 的 最 好 时 机 ， 即 在 其 他 中 断 服务 程序 执行 过 程 中 不 进行 任务 切换 ， 又 可 以 在 中 断 结束 的 时 候 进行 切换 。HC/OS-lll 是 可 剥 


和 夺 型 内 核 ， 这 就 要 求 高 优先 级 的 任务 应 该 尽快 执行 ， 任 务 切 换 除 了 在 中 断 不 能 进行 ， 因 为 中 断 是 要 比 最 高 优先 级 任务 还 要 紧急 的 事情 。 


31 24 23 16 15 Ss 


E000ED18 


E000ED1C 


E000ED20 





图 14-10 优先 级 置 位 及 其 地 址 


第 6、7 行 将 PSP 设 置 为 0， 作 为 系统 第 一 次 进行 任务 调度 的 标志 ， 前 面 已 经 讲 过 。 


前 面 我 们 讲 过 在 异常 的 时 候 我 们 使 用 的 堆栈 指针 是 MSP， 婚 然 任 务 使 用 PSP 需 要 堆栈 ， 那 么 MSP 也 需要 堆栈 。 在 STM32 进 入 main 函 数 之 前 ， 先 
进行 了 堆栈 的 分 配 ， 主 要 是 分 配给 MSP 的 。HC/OS- 咱 在 第 9~11 行 为 MSP 重 新 分 配 了 堆栈 ， 这 个 堆栈 主要 是 在 中 断 嵌 套 的 时 候 可 以 将 寄存 器 、 局 部 


变量 等 进行 入 栈 。 所 以 如 果 中 断 程序 比较 大 或 者 中 断 庶 套 比较 多 ， 注 意 要 将 这 个 堆栈 空间 设置 大 点 ， 不 能 只 关注 任务 的 堆栈 。 首 先是 定义 一 个 数组 。 





CPU STK OSCfg ISRStk [OS CFG ISR STK SIZE] 
CPU STK * const OSCfg ISRStkBasePtr = (CPU STK *) &OSCfg ISRStk[0]; 


接着 计算 出 堆栈 的 基地 址 ， 因 为 Cortex-M3 的 堆栈 增长 方向 是 从 高 到 低 ， 所 以 由 以 下 的 表达 式 计算 出 堆栈 的 基地 址 ， 实 际 上 就 是 最 后 一 个 元 素 的 
地 址 。 


OS_CPU ExceptStkBase = (CPU STK *) (OSCfg ISRStkBasePtr + OSCfg ISRStkSize - 1u); 





最 后 第 13~17 行 进行 触发 PendSV， 打 开 中 断 进 行 任务 调度 。 


14.6 ”任务 堆栈 初始 化 遂 数 OSTaskStklnit 解 析 


任务 堆栈 初始 化 函数 OSTaskSstklnit 的 具体 代码 见 代码 清单 14-4。 


代码 清单 14-4 “任务 堆栈 初始 化 函数 OSTaskSstklnit 


1 CPU STK *OSTaskStkInit (OS TASK PTR  p task, 

4 void *p_arg, 

3 CPU_STK *p_stk base, 
4 CPU_STK *p stk limit, 
| CPU _STK SIZE stk size, 

6 OS_OPT opt) 

7{ 

8 CPU STK *p stk; 

9 

10 

证 (void) opt; // 防止 编译 器 报错 
12 

Me 


p stk = &p stk base[stk sizel]; // 取出 任务 堆栈 后 面 的 地 址 








15 *--P_Sstk = (CPU STK) Ox01000000u; /* xPSR w*/ 

16  *--p stk = (CPU STK)p task; /* Entry Point */ 
17 *--P_stk = (CPU STK)OS TaskReturn; /* R14 (LR) wy 

18 *--p stk = (CPU STK) 0x12121212u; /* R12 #7 

19 *--p_ stk = (CPU_STK)Ox03030303u; ~ /* R3 上 

20 *--p stk = (CPU STK) 0x02020202u; /* R2 wh 

21 *--p stk = (CPU STK)p stk limit; /* Rl 4 

22 *--p stk = (CPU STK)p arg? /* RO : argument*/ 
23 

24 *--P_ stk = (CPU STK)Ox11111lillu; /* R11 */ 

25 *--p stk = (CPU STK) 0x10101010uy  /* R10 */ 

26 *--p stk = (CPU STK)Ox09090909u; /*R9 */ 

27 *--Db_ stk = (CPU STK)Ox08080808u; /* R8 */ 

28 *--p_ stk = (CPU STK)Ox07070707u; /* R7 */ 

29 *--p stk = (CPU STK)Ox06060606u; /* R6 */ 

30 *-—p stk = (CPU STK)Ox05050505u; /* R5 */ 

31 *--p_stk = (CPU STK)Ox04040404u; /* R4 */ 

32 

33 return (p stk); 

34 } 


在 前 面 讲解 任务 切换 的 过 程 中 存在 一 个 问题 ， 每 次 切换 到 新 的 任务 时 ， 都 要 从 新 任务 的 堆栈 中 弹出 寄存 器 的 值 ， 而 新 任务 的 堆栈 都 是 上 次 任务 切 
换 的 时 候 将 寄存 器 入 栈 所 得 。 如 果 新 任务 是 第 一 次 运行 ， 就 不 存在 所 谓 的 “上 次 切换 的 时 候 ”， 那 么 到 底 各 个 任务 第 一 次 运行 的 时 候 ， 堆 栈 中 的 值 是 
从 哪里 来 的 呢 ?” 这 就 需要 我 们 在 创建 任务 的 时 候 对 任务 堆栈 进行 初始 化 ， 函 数 OsTaskSstklnit 就 是 用 来 对 堆栈 的 初始 化 的 ， 整 个 过 程 就 是 模拟 CPU 入 
栈 的 过 程 ， 就 是 简单 地 把 对 应 的 内 容 模拟 入 栈 的 顺序 放 入 我 们 之 前 已 经 分 配 好 的 的 任务 堆栈 。 其 中 相对 任务 只 有 部 分 内 容 有 意义 。 任 务 寄存 器 进 栈 的 
顺序 如 图 14-11 所 示 。 
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图 14-11 Cortex-M3 寄 存 器 入 栈 顺 序 


首先 是 图 14-12 的 xPSR， 寄 存 器 xPSR 的 值 对 于 第 一 次 执行 的 任务 来 说 没有 什么 意义 。xPSR 是 由 三 个 寄存 器 构成 的 ， 分 别 是 APSR、1PSR、 
EPSR。 其 中 EPSR 的 T 位 在 Cortex-M3 中 必须 为 1， 即 XPSR 的 24 位 必须 为 1， 所 以 放 0x01000000u 进 xPSR 对 应 的 在 栈 的 位 置 。 


Exception Number 





Cortex-M3 中 的 程序 状态 寄存 器 (XPSR ) 


加 加 EGG EEC 





"le el ole | Be 症 忆 22 


合体 后 的 程序 状态 寄存 器 (xPSR) 


图 14-12 ”寄存 器 xPSR 的 内 容 


接着 是 PC，PC 比 较 重要 ， 他 决定 了 任务 第 一 次 开始 运行 时 任务 跳 转 到 的 地 方 ， 任 务 第 一 次 运行 肯定 是 从 任务 最 开始 的 地 方 运行 ， 所 以 将 任务 的 
地 址 赋 给 PC。 


如 果 用 户 任务 不 写成 无 限 循 环 的 形式 ， 到 任务 的 最 后 会 跳 转 到 LR 寄 存 器 指向 的 地 址 ， 这 跟 函 数 调 用 是 一 样 的 ， 运 行 到 任务 的 结尾 就 要 返回 。LR 
寄存 器 赋值 为 0S_ TaskReturn， 这 是 一 个 函数 指针 ， 具 体 的 函数 代码 见 代 码 清单 14-5。 这 个 函数 在 系统 允许 删除 任务 的 情况 下 ， 即 将 
OS_CFG_TASK_DEL EN 赋值 为 1 的 时 候 ， 将 任务 进行 删除 。 任 务 删除 函数 后 面 讲解 。 如 果 不 允 许 删除 任务 ， 那 么 就 进入 一 段 无 限 循环 的 程序 。 这 增 
加 了 系统 的 健壮 性 ， 不 会 出 现 用 户 不 小 心 没 有 将 任务 写成 无 限 循 环 的 形式 系统 就 奔 溃 了 的 情况 。 


代码 清单 14-5 ”任务 返回 图 数 Os_ TaskReturn 








1 void OS TaskReturn (void) 

2 { 

3 OS ERR err; 

a 

5 

6 

7 OSTaskReturnHook (OSTCBCurPtr); 

8 #if OS CFG TASK DEL EN > 0u // 是 否 可 以 进行 删除 任务 的 操作 
9 OSTaskDel ( (OS_TCB *)0， 

10 (OS_ERR *) &err); 

11 #else 

12 for (;;) { // 无 限 循环 
13 OSTimeDly ( (OS_TICK )OSCfg TickRate Hz, 
14 (OS OPT  )0S OPT TIME DLY, 
13 (OS_ERR *)&err); 

16 } 

17 #endif 

18 } 





RO 存放 的 是 创建 任务 是 传递 进来 的 参数 ，R1 存 放 的 是 堆栈 限制 增长 到 的 内 存 地 址 。 


其 他 的 寄存 器 由 于 对 一 开始 运行 的 任务 没有 什么 意义 ， 只 是 简单 地 赋予 一 些 方便 调试 的 数据 。 比 如 R12 就 赋值 为 0x1212121212。 


14.7 ”验证 初始 化 堆栈 弹 栈 结 果 


接 下 来 我 们 运用 MDK 软 件 仿真 来 查看 这 些 数据 从 任务 堆栈 中 弹出 到 寄存 器 的 过 程 。 首 先 复位 程序 ， 将 断 点 设置 在 任意 一 个 程序 开始 即 可 ， 注 意 
一 定 保证 任务 是 第 一 次 运行 。 寄 存 器 的 值 如 图 14-13 所 示 。 























医 因 0s_cpu_aasm 周 [3 响 






秃 数 名 : Task Start 
述 ”: 启动 任务 ， 
优先 级 为 3， 
创建 LED1、LED2 和 LED3 的 任务 
输入 : 无 
输出 :无 
22 void Task_Start (void *p arg) 


24 OS_ERR err: 
25 (void)p_arg:; 


27 // 创 建 任务 LED1 































t 28 0STaskCreate((0S_TCB *) &LED1_TCB, 
4 29 (CPU CHAR  *)”LED1”, 
和 Thread 30 (OS_TASK_PTR )Task_LED1， 
Privilege Privileged Sj (void *) 0， 
| 入 之 (OS_PRIO )TASK_ LED1_PRI0， 
Sac 0.00045319 3 (CPU_STK *) &LED1_Stk[L0], 
34 (CPU STK_SIZE)TASK LED1_STK_SIZE/10， 
95 (CPU_STK_SIZE)TASK LED1 STK_SIZE, 
36 (0S_MSG QTY )0, 
1 (OS_TICK )0, 
38 (void *) 0， 
39 (0S_0PT ) (0S_ OPT_TASK_STK_CHK | 
40 0S_OPT_TASK_STK_CLR), 
41 (OS_ERR *) &err) : 
图 14-13 ”软件 仿真 验证 CPU 堆栈 和 寄存 器 


左 侧 大 部 分 的 寄存 器 的 内 容 是 跟 我 们 设置 的 一 样 的 ， 比 如 R2~R12 这 些 都 是 我 们 用 来 调试 的 值 。 其 他 的 寄存 器 的 一 些 奇怪 的 值 可 能 有 些 读者 就 不 
明白 了 。 其 实 很 简单 ， 例 程 中 传递 的 参数 是 0， 所 以 寄存 器 RO 的 值 为 0。 


代码 清单 14-6 是 任务 控制 块 和 任务 堆栈 的 定义 ， 代 码 清单 14-7 是 一 段 创建 任务 的 代码 。 


代码 清单 14-6 “任务 控制 块 和 任务 堆栈 的 定义 





1 Os TCB StartUp TCB; // 定义 任务 控制 块 
2 CPU STK StartUp Stk[STARTUP TASK STK SIZE];  // 定义 任务 堆栈 





代码 清单 14-7 ”任务 创建 代码 





1 /* 创 建 任务 */ 


2 OSTaskCreate ( (OS_TCB *) &StartUp TCB, // 任务 控制 块 指针 

3 (CEU CHAR  *)"StartUp", // 任务 名 称 

4 (OS_TASK PTR )Task Start, // 任务 代码 指针 

5 (void *)0, // 传递 给 任务 的 参数 parg 
6 (OS_PRIO ) STARTUP TASK PRIO, // 任务 优先 级 

7 (CEU STK *)&StartUP Stk[0], // 任务 堆栈 基地 址 

8 (CPU STK SIZE)8, // re 

9 (CPU STK SIZE)STARTUP TASK STK SIZE, // 堆栈 大 

10 (OS MsG OTY )o0, // 本 按 届 的 最 大 消息 队列 数 
11 (OS_ TICK )0, // 时 间 片 轮转 时 间 

12 (void *)0, // 任务 控制 块 扩展 信息 
13 (OS_OPT ) (OS OPT TASK STK CHK | 

14 OS_ OPT TASK STK CLR), // 任务 选项 

15 (OS_ERR *) &err); // 返回 值 





创建 任务 的 时 候 第 7 个 参数 设置 剩 下 8 个 数组 元 素 的 空间 ( 共 32 个 字 节 ， 堆 栈 类 型 CPU_STK 是 32 位 的 ) 的 地 方 为 堆栈 警戒 线 ， 推 理 可 知 ，R1 的 地 
址 为 StartUp_Stk+32， 那 怎么 知道 数组 的 基地 址 StartUp_Stk 呢 ? 在 各 个 工程 的 名 字 为 Listing 子 文件 夹 下 都 有 个 Template.map 文 件 ， 通 过 查找 这 个 
文件 我 们 就 可 以 知道 函数 以 及 变量 等 在 芯片 中 的 具体 地 址 ， 非 常 方便 调试 程序 。 我 们 用 记事 本 打开 这 个 文件 ， 找 到 startUp_stk 的 相关 信息 如 下 。 





StartUp Stk ”0x20000114 Data 320 main.o(.bss) 





由 此 信息 可 以 知道 数组 的 基地 址 StartUp_Stk 为 0x20000114， 加 上 32 为 0x20000134， 即 是 理论 上 R1 的 值 ， 也 是 仿真 窗口 R1 的 值 ( 见 图 14- 
14) 。 









GS 
SS 


StartUp_Stk[STARTUP_ TASK_STK_SIZE-1] 高 地 址 










GG Eh 
: 2 增 
ws 7 1 : 
1 和 Der 和 
空间 ， 共 32 个 

字 节 


StartUp_Stk[0] 低地 址 


图 14-14 STM32 扒 栈 警 戒 线 


根据 前 面 的 分 析 ， 寄 存 器 LR 是 函数 指针 OS_ TaskReturn 的 值 ， 同 样 地 ， 我 们 可 以 在 Template.map 文 件 中 找到 以 下 的 信息 ， 所 以 理论 上 寄存 器 LR 
的 值 应 该 是 0x0800340b， 也 是 跟 仿真 结果 一 样 的 。 





OS_TaskReturn 0x0800340b Thumb Code 20 os task.o(.text) 





寄存 器 PC 的 值 的 分 析 过 程 跟 上 面 一 致 ， 只 不 过 这 次 我 们 发 现 ， 寄 存 器 PC 的 仿真 值 为 0xX08000b7A， 而 任务 代码 指针 Task_Start 却 是 
0x08000b7b， 这 两 者 的 最 低位 一 个 是 0， 一 个 是 1。 对 此 在 《Cortex-M3 权 威 指南 》 中 有 如 图 14-15 寄 存 器 PC 的 LSB 说 明 ， 即 加 载 进 PC 的 指令 要 求 最 
低位 是 1， 而 从 PC 中 读 取 的 指令 的 最 低位 总 是 0。 这 也 就 解释 了 为 什么 任务 代码 指针 和 寄存 器 PC 的 值 的 最 低位 会 不 同 。 

















Task Start 0x08000b7b Thumb Code 162 app.o(.text) 





如 果 向 PC 中 写 数 据 ， 就 会 引起 一 次 程序 的 分 支 ( 但 是 不 更 新 LR 寄存 器 ) 。CM3 中 的 指令 至 少 
是 半 字 对 齐 的 ， 所 以 PC 的 LSB 总 是 读 回 0。 然 而 ， 在 分 支 时 ， 无 论 是 直接 写 PC 的 值 还 是 使 用 分 支 指 


令 ， 都 必须 保证 加 载 到 PC 的 数值 是 奇数 ( 即 LSB=1 ) ， 用 以 表明 这 是 在 Thumb 状 态 下 执行 。 倘 若 写 
了 0， 则 视 为 企图 转 入 ARM 模 式 ，CM3 将 产生 一 个 fault 异 党 





图 14-15 ”寄存 器 PC 的 LSB 说 明 


14.8 ”中 断 级 任务 切换 的 宏 OSIntCtxSw() 解 析 


中 断 级 任务 切换 的 时 候 是 在 退出 中 断 嵌 套 的 时 候 ， 这 个 时 候 之 前 的 任务 主要 的 寄存 器 已 经 在 进入 第 一 层 中 断 的 时 候 入 栈 了 。 我 们 需要 做 的 仅 仪 只 
是 将 剩 下 的 还 没有 入 栈 的 寄存 器 进行 入 栈 操作 ， 之 后 跟 任务 级 任务 切换 的 过 程 是 一 模 一 样 的 。 对 比 中 断 级 任务 切换 ， 任 务 级 任务 切换 多 了 一 个 CPU 自 
动 入 栈 的 过 程 。 中 断 级 任务 切换 因为 在 进入 中 断 的 时 候 做 的 也 是 将 任务 的 寄存 器 入 栈 ， 所 以 可 以 省 略 这 不 操作 ， 直 接 进行 任务 切换 后 面 的 工作 。 可 是 
当 读 者 追踪 OSIntCtxSw0 的 定义 的 时 人 息 ， 发 现 跟 任 务 级 任务 切换 的 宏 OS_TASK_SW0 完 全 相同 。 前 面 刚 说 任务 级 任务 切换 跟 中 断 级 任务 切换 不 同 ， 怎 
么 都 是 触发 异常 PendSV? 





1 #define OS TASK SW() NVIC_INT CTRL = NVIC PENDSVSET 
2 #define OSIntCtxSw() NVIC_INT CTRL = NVIC PENDSVSET 








这 两 个 过 程 的 不 同体 现在 CPU 内 部 的 处 理 上 。Cortex-M3 硬 件 上 有 一 个 “中 断 咬 尾 ”的 机 制 。 如 果 中 断 返 回 的 时 候 发 现 有 悬 起 的 中 断 ，CPU 就 
不 会 先 出 栈 再 入 栈 。 要 返回 的 中 断 之 前 已 经 将 寄存 器 入 栈 了 ， 直 接 进 入 悬 起 的 中 断 就 多 出 了 出 栈 再 入 栈 这 无 谓 的 时 间 。 就 像 有 两 个 人 甲 和 乙 ， 甲 从 仓 
库 中 拿 了 工具 去 干 活 ， 干 完 活 轮 到 乙 了 ， 这 个 时 候 如 果 甲 不 直接 将 工具 给 乙 ， 而 是 先 放 回 仓库 ， 然 后 再 让 乙 去 拿 ， 估 计 甲 会 被 人 说 很 傻 。 明 明 你 直接 
把 工具 给 乙 就 好 了 ， 不 用 跑 一 趟 路 到 仓库 去 放 工具 ， 乙 也 不 用 跑 到 仓库 去 拿 。 昌 然 任务 级 任务 切换 和 中 断 级 任务 切换 两 者 都 是 悬 起 异常 PendSV， 但 


是 中 断 级 任务 切换 是 在 最 后 一 层 中 断 谋 套 的 最 后 悬 起 PendSV 的 ， 硬 件 上 自动 会 进行 “中 断 咬 尾 ”操作 ， 过 程 自 然 不 完全 跟 任 务 级 任务 切换 一 样 。 现 
在 就 可 以 回头 看 看 我 们 之 前 在 1.7.1 一 一 中 断 谋 套 层 数 统计 中 提 到 的 函数 ， 在 退出 中 断 的 时 候 将 嵌 套 层 数 减 1 后 使 能 中 断 ， 如 果 需 要 进行 任务 切换 (之 
前 有 悬 起 异常 PendSV) ， 这 个 时 候 就 进行 “中 断 咬 尾 ”。 


14.9 ”任务 切换 过 程 中 出 现 中 断 的 处 理 


前 面 对 任 务 切 换 过 程 理解 比较 深 的 读者 可 以 自己 想 想 : 如 果 在 任务 切换 过 程 中 出 现 中 断 ， 系 统 或 者 CPU 会 进行 怎样 的 处 理 。 这 里 将 可 能 的 几 种 情 
况 列 出 来 ， 以 便 读 者 对 任务 切换 能 有 更 深 的 理解 。 


1) 如 果 在 触发 异常 之 前 已 经 发 生 中 断 : 我 们 通常 会 设置 PendSV 的 优先 级 为 最 低 ， 所 以 这 个 时 候 会 晤 起 PendSV， 等 待 其 他 的 高 优先 级 中 断 全 部 
执行 完毕 再 执行 PendSV 异 常服 务 程序 。 


2) 如 果 是 在 CPU 执行 自动 入 栈 这 个 过 程 发 生 中 断 : Cortex-M3 有 个 晚 到 (高 优先 级 ) 中 断 ， 这 个 时 候 还 是 会 切换 到 高 优先 级 中 断 ，PendsV 相 
当 于 是 帮助 了 高 优先 级 进行 入 栈 操作 。 


3) 执行 PendSV 异 常服 务 程序 的 时 候 发 生 中 断 : 进入 PendSV 异 常服 务 程序 首先 就 关闭 了 中 断 ， 进 入 临界 区 ， 有 些 中 断 可 能 会 被 悬 起 ， 有 些 中 断 
像 SVC 异 常 可 能 会 上 访 成 硬 fault。 


14.10 “总结 


任务 切换 的 过 程 总 体 上 来 看 还 是 比较 简单 ， 只 不 过 有 很 多 细节 需要 注意 ， 如 果 对 整个 过 程 还 是 一 知 半 解 ， 建 议 将 本 章 多 看 几 遍 ， 和 融会贯通。 任务 
切换 程序 首先 用 软件 进行 触发 PendSV 异 常 ，CPU 自 动 将 当前 的 任务 的 寄存 器 保存 到 堆栈 中 ， 执 行 PendSV 异 常服 务 程序 。 在 PendSV 异 常服 务 程序 中 
我 们 将 CPU 没有 保存 的 寄存 器 保存 到 任务 的 堆栈 中 去 ， 接 着 把 要 切换 到 的 任务 上 一 次 切换 的 时 候 保存 的 堆栈 指针 赋 给 任务 执行 过 程 一直 使 用 的 进程 堆 
栈 PSP， 退 出 异常 服务 程序 后 从 新 的 任务 堆栈 中 进行 弹 栈 。 此 时 的 环境 就 好 像 又 恢复 到 了 新 任务 上 次 被 切换 之 前 。 我 们 对 于 任务 切换 并 不 陌生 ， 之 前 
我 们 经 常用 到 的 中 断 不 就 跟 任务 切换 很 相似 么 。 中 断 的 过 程 是 从 目前 正在 执行 的 程序 跳 转 到 中 断 服 务 例 程 中 ， 都 涉及 上 下 文 切 换 ， 任 务 切 换 也 就 是 从 
一 个 任务 跳 转 到 另外 一 个 任务 。 只 不 过 CPU 有 处 理 中 断 的 相关 硬件 条 件 ， 没 有 实现 任务 切换 的 相关 硬件 条 件 ， 因 此 任务 切换 就 需要 自己 编写 相关 的 代 
码 来 进行 。 本 章 讲解 的 其 他 的 “中 断 咬 尾 ”“ 晚 到 (的 高 优先 级 ) 异常 ”、Cortex-M3 堆 栈 等 有 关 知 识 务必 要 耐心 地 理解 ， 可 以 结合 《Cortex-M3 
权威 指南 》 进 行 阅读 。 


第 15 章 “任务 管理 


本 章 主要 介绍 与 任务 管理 相关 的 内 容 。 首 先 介绍 任务 的 诞生 过 程 一 一 任务 创建 ; 接着 讲解 任务 的 挂 起 和 取消 挂 起 两 个 操作 ; 最 后 介绍 时 间 片 轮转 
调度 和 一 个 简单 的 任务 寄存 器 。 


15.1 任务 创建 


前 面 已 经 接触 过 很 多 次 任务 创建 的 代码 ， 本 节 将 仔细 剖析 任务 创建 函数 OsTaskCreate 中 每 个 参数 的 意义 。 
1) p_tcb: 指向 任务 控制 块 的 指针 。 


2) p_name: 指向 任务 控制 块 变量 名 字符 串 的 指针 。 


3) p_task: 指向 任务 地 址 。 
4) p_arg: 指向 任务 参数 的 指针 。 每 个 任务 允许 以 指针 的 形式 传递 一 个 参数 。 


5) prio: 任务 优先 级 ， 这 个 值 越 小 ， 优 先 级 越 高 。 这 个 值 的 范围 只 能 是 小 于 等 于 OS_CFG_PRIO_MAX-2， 且 大 于 或 等 于 1。 
OSs_CFG_PRIO_MAX 宏 定义 大 小 可 以 自己 定义 ， 在 例 程 中 的 值 都 是 64。 最 高 优先 级 和 最 低 优先 级 分 别 被 中 断 处 理 任务 和 空闲 任务 占据 ， 虽 然 HC/OS- 
川 允许 多 个 任务 共同 占有 同一 个 优先 级 但是， 如 果 任务 占有 最 高 和 最 低 两 个 优先 级 ， 则 会 影响 中 断 处 理 任务 和 空闲 任务 的 功能 。 不 过 在 中 断 延 迟 功 
能 关闭 后 ， 中 断 处 理 任务 就 不 存在 ， 这 时 可 以 使 用 优先 级 最 高 的 任务 。 





6) p_stk_base: 任务 堆栈 最 低 的 地 址 ， 如 果 定 义 一 个 数组 当成 一 块 堆 栈 ， 那 么 数组 的 首 地 址 要 传递 给 这 个 参数 。 每 个 任务 都 是 一 个 线程 ， 需 要 
有 独自 的 堆栈 。 


7) stk_size: 堆栈 大 小 。 不 能 小 于 宏 OS_CFG_STK_SIZE_MIN 定 义 的 数据 大 小 ， 不 然 创建 任务 会 出 错 ， 在 例 程 中 定义 OS_CFG_STK_SIZE_MIN 
的 值 是 64。 


8) stk_limit: 堆栈 的 限制 。 比 如 这 个 参数 设置 为 stk_size/10， 即 表示 堆栈 限制 在 stk_size 的 90%。 


9) q_size: 任务 消息 队列 的 容量 ， 注 意 使 用 任务 消息 队列 的 时 候 不 能 将 这 个 参数 设置 为 0。 





10) time quanta: 时 间 片 大 小 。 

11) p_ext: 任务 拓展 。 

12) opt: 任务 选项 ， 主 要 有 以 下 几 种 类 型 。 

- OS_OPT_TASK_NONE: 没有 任何 设置 。 

* OS_OPT_TASK_STK_CHK: 如 果 参 数 包 含 这 个 选项 ， 表 示 后 面 可 以 进行 堆栈 检测 ， 后 面 会 详细 解释 。 
" OS_OPT_TASK_STK_CLR: 堆栈 全 部 进行 清 0 操 作 。 


. OS_OPT_TASK_SAVE_FP: 任务 是 否 保 存 浮 点 寄存 器 ， 所 用 的 芯片 中 没有 用 到 浮 点 寄存 器 ， 此 项 不 进行 介绍 。 





13) p_err: 指向 返回 错误 类 型 的 指针 ， 主 要 有 以 下 几 种 类 型 (只 包含 部 分 ) 。 


. OS_ERR_NONE: 没有 错误 。 





` OS_ERR_NAME: 参数 p_name 是 空 指针 。 

" OS_ERR_PRIO_INVALID: 优先 级 设置 错误 ， 详 见 前 面 参数 ptio 的 设置 说 明 。 
" OS_ERR_STK_INVALID: 堆栈 不 可 用 ， 参 数 p_stk_base 是 空 指针 。 

. OS_ERR_STK_SIZE_INVALID: 堆栈 大 小 设置 不 可 用 ，stk_size 为 0。 

* OS_ERR_STK_LIMIT_INVALID: 堆栈 限制 大 小 大 于 或 等 于 堆栈 设置 大 小 。 


. OS_ERR_TASK_CREATE_ISR: 企图 在 中 断 中 创建 任务 。 





. OS_ERR_TASK_INVALID: 参数 p_task 是 空 指针 。 
" OS_ERR_TCB_INVALID: 参数 p_tcb 是 空 指针 。 
任务 创建 的 函数 OSTaskCreate 如 代码 清单 15-1 所 示 。 


代码 清单 15-1 ”任务 创建 函数 OSTaskCreate 


1 void OSTaskCreate (OS_ TCB *p_tcb, 
2 CPU_CHAR *p_name, 
3 OS_TASK PTR p_task, 
4 void *p_arg, 
3 OS_PRIO prio, 





6 CPU _STK *p_stk base, 
7 CPU STK SIZE stk limit, 
8 CPU STR SIZE stk size, 
9 OS_ MSG QTY q_size, 

10 OS_ TICK time quanta, 
LT void *p_ext, 

12 OS_OPT opt, 

13 OS_ERR xp Srr) 

14 { 

15 CPU STK SIZE i; 

16 #if OS CFG TASK REG TBL SIZE > 0u 

17 OS OBJ QTY reg_nbr; 

18 #endif 

19 CPU_ STK *p_sp; 

20 CPU_STK *p_stk limit; 

21 CPU SR ALLOC(); 

22 

23 


24 // 是 否定 义 安全 检查 的 宏 
25 #ifdef OS SAFETY CRITICAL 





26 if (p err == (OS ERR *)0) { 

27 // 如 果 传 入 的 参数 PD err 是 空 指针 ， 那 么 将 进入 安全 关键 异常 ， 这 部 分 需要 用 户 自己 编写 
已 下 OS_SAFETY _ CRITICAL _ EXCEPTION () 7 

29 return; 

30 } 

31 #enqif 

32 


33 // 是 否 启 动 安全 关键 
34 #ifgdef OS SAFETY CRITICAL IEC61508 





35 // 一 旦 调用 OSSafetyCriticalSstart，OSSafetyCriticalStartFlag 就 被 置 为 36 
36 DEF_TRUE, 不 再 允许 创建 内 核对 象 。*/ 

37. if (OSSafetyCriticalStartFlag == DEF TRUE) { 

38 *p err = OS ERR ILLEGAL CREATE RUN TIME; 

39 return; 

40 } 

41 #endif 

42 


43 // 不 能 在 中 断 中 调用 创建 任务 函数 
44 #if OS CFG CALLED FROM ISR CHK EN > 0u 








45 if (OSIntNestingCtr > (OS NESTING CTR) 0) { 
46 *p err = OS ERR TASK CREATE ISR; 

47 return; 

48 } 

49 #endif 

50 


51 // 进行 参数 检测 
52 #if OS CFG ARG CHK EN > Ou 




















53 // 检测 参数 p tcb 是 否 为 空 指针 

54 if (p tcb = (OS TCB *)0) { 

35 *p err = OS ERR TCB INVALID; 

56 return; 

sy = 

58 

59 // 检测 参数 p_task 是 否 为 空 指针 

60 if (p task == (OS TASK PTR)0) { 

61 *p err = OS ERR TASK INVALID; 

62 return; 

63 } 

64 

65 // 检测 参数 P_stk base 是 否 为 空 指针 

66 if (p stk base == (CPU STK *)0) { 

67 *p err = OS ERR STK INVALID; 

68 return; 

69 } 

70 

71 // 堆栈 至 少 应 该 大 于 我 们 设 定 的 最 小 值 OSCfg StkSizeMin 
72 if (stk size < OSCfg StkSizeMin) { 

73 *p err = OS ERR STK SIZE INVALID; 
74 return; 

75 } 

76 

77 // 限制 的 堆栈 大 小 肯定 不 能 超过 整个 堆栈 的 大 小 
78 if (stk limit >= stk size) { 

了 8 *p err = OS ERR STK LIMIT INVALID; 
80 return; 

81 } 

82 

83 // 任务 优先 级 不 能 大 于 设置 的 最 大 优先 级 

84 if (prio >= OS CFG PRIO MAX) { 

85 *p err = OS ERR PRIO INVALID; 

86 return; 

87 } 

88 #endif 

89 

90 


91 // 如 果 允 许 延迟 提交 ， 那 么 优先 级 为 0 的 任务 是 延迟 提交 的 ， 任 务 不 能 设置 为 此 优先 级 
92 #if OS CFG ISR POST DEFERRED EN > 0u 








93 if (prio == (OS _ PRIO)O0) { 

94 if (p tcb != &OSIntQTaskTCB) { 

95 *p err = OS ERR PRIO INVALID; 
96 return; 

97 } 

98 } 

99 #endif 

100 

101 // 最 低 优先 级 为 空闲 任务 ， 任 务 不 能 设置 为 此 优先 级 
102 if (prio == (OS_CFG PRIO MAX - 1u)) { 
103 if (p tcb != &OSIdqleTaskTCB) { 
104 *p err = OS ERR PRIO INVALID; 





105 return; 
106 } 


107 } 





108 

109 // 初始 化 任务 控制 块 

110 OS TaskInitTCB (p tcb); 

Tl: 

112 *p err = OS ERR NONE; 

L113 

114 // 创建 任务 的 时 候 ， 如 果 有 选项 0S OPT TASK STK CHK 和 OS OPT TASK STK CLR, 
TLS // 则 从 低地 址 开始 将 所 有 的 堆栈 空间 初始 化 为 0， 后 面 可 以 计算 最 大 的 堆栈 使 用 情况 
116 if ((opt & OS OPT TASK STK CHK) != (OS OPT)0) { 

L117 if ((opt & OS OPT TASK STK CLR) != (OS OPT)0) { 

118 Pp sp = p stk base; 

119 for (EE 三 宇和 stk Size 1++). { 

120 *p sp = (CPU STK)O; 

2 p_sptt+; 

122 } 

123 } 

124 } 

125 


126 // 根据 堆栈 增长 方向 ， 计 算 限制 堆栈 的 那个 地 址 
127 #if (CPU CFG STK GROWTH == CPU_STK GROWTH HI TO LO) 





128 pi stk | limit = p stk base + stk limit; 

129 #else 

130 p stk limit = p stk base + (stk size - lu) - stk limit; 
131 #endif 

432 


133 // 对 堆栈 进行 初始 化 ， 初 始 化 的 内 容 将 在 第 一 次 进行 任务 切换 的 时 候 恢复 为 寄存 器 的 值 
134 // 最 后 返回 初始 化 堆栈 后 返回 堆栈 指针 。 








135 p_sp = OSTaskStkInit (p task, 

136 p_arg, 

137 p_stk base, 

138 pi stk . :limit; 

139 stk size, 

140 opt); 

141 

142 // 保存 任务 地 址 到 任务 控制 块 元 素 TaskEntryAddr 
143 p tcb->TaskEntryAddr = p task; 

144 

145 // 保存 任务 参数 到 任务 控制 块 元 素 TaskEntryArg 
146 p tcb->TaskEntryArg = p arg; 

147 

148 // 保存 任务 的 名 称 到 任务 控制 块 元 素 NamePtr 

149 p_tcb->NamePtr = p_name; 

150 

LS // 保存 任务 的 优先 级 到 任务 控制 块 元 素 Prio 

32 p_tcb->Prio = prio; 

153 

154 // 保存 任务 的 堆栈 指针 到 任务 室 制 块 元 素 StkPtr 
.55 p_tcb->StkPtr = p_sp; 

156 

157 // 保存 任务 的 堆栈 限制 增长 地 址 到 任务 控制 块 元 素 StkLimitPtr 
158 p tcb->StkLimitPtr = p stk limit; 

159 

160 // 保存 任务 的 时 间 片 到 任务 控制 块 元 素 time_quanta 
161 p_tcb->TimeQuanta = time quanta; 

162 


163 // 允许 进行 时 间 片 轮转 调度 
164 #if OS CFG SCHED ROUND ROBIN EN > 0u 





165 // 如 果 设 置 时 间 片 time_quanta 为 0， 参 数 时 间 片 计数 值 为 默认 的 0SSchedRoundRobinDfltTimeQuanta 
166 // 为 OSCfg TickRate Hz/10u， 即 100， 否 则 为 参数 的 设置 。 

167 if (time quanta == “(0S TICK)0) { 

168 p_tcb->TimeQuantaCtr = OSSchedRoundRobinDf1tTimeQuanta; 
169 } else { 

170 p_ tcb->TimeQuantaCtr = time quanta; 

于/ 下 } 

172 #engif 

173 

174 // 保存 任务 的 拓展 内 容 到 人 该 参数 为 无 确切 类 型 指针 
T1715 p_tcb->ExtPtr = 

176 /7 保 褒 任务 堆 扩 的 低地 址 到 位 秀 失 抽奖 元 素 StkBasePtr 

177 p_tcb->StkBasePtr p_ stk base; 

178 /7 保存 任务 堆栈 的 大 小 到 任务 辽 制 并 元 素 StkSize 

179 p_tcb->StkSize = stk size; 

180 // 保存 任务 创建 时 的 选项 到 任务 控制 块 元 素 Opt 

181 p_tcb->Opt = Opt; 

182 


183 // 如 果 允 许 使 用 任务 “寄存 器 ” 
184 #if OS CFG TASK REG TBL SIZE > Ou 

















185 

186 // 初始 化 任务 的 0OS_CFG TASK REG TBL SIZE 个 “寄存 器 ”都 为 0。 

187 // 0S CFG TASK REG TBL SIZE 默 认 值 为 1 

188 for (reg nbr = Ou; reg nbr < OS CFG TASK REG TBL SIZE; reg nbr++) { 
189 p tcb->RegTbl [reg nbr] = (0S REG)O; 

190 } 

191 #endif 

192 


193 // 如 果 允 许 使 用 任务 消息 队列 
194 #if OS CFG TASK Q EN > 0u 


195 

196 // 初始 化 任务 消息 队列 

197 OS MsgQInit (gp tcb->MsgoQ, 

198 q size); 

199 #engdif 

200 

201 // 调用 任务 创建 时 的 回调 函数 0STaskCreateHook， 用 户 可 以 对 函数 
202 // 0S_AppTaskCreateHookPtr 进 行 编写 
203 OSTaskCreateHook (p_ tcb); 

204 

205 

206 OS_CRITICAL ENTER(); 


207 


208 // 置 就 绪 优 先 级 位 映像 表 中 相应 优先 级 处 于 就 绪 状态 
209 OS_PrioInsert (p tcb->Prio) 








210 
21 // 将 新 创建 的 任务 插入 就 绪 列 表 末 尾 
212 OS_ RdyListIinsertTail (p tcb); 
213 
214 // 如 果 允 许 调试 的 宏 ( 主 要 将 各 种 内 核对 象 囊 成 双向 链表 ， 以 方便 调试 ) 
215 #if OS CFG DBG EN > 0u 
216 // 就 将 任务 添加 到 任务 的 双向 链表 中 
217 OS_ TaskDbgListAgdd (p tcb); 
218 #endif 
219 
220 // 更 新 任务 数目 
221 OSTaskQty++; /* Increment the #tasks counter */ 
222 
223 // 只 有 系统 启动 了 才 开 始 后 面 的 任务 调度 
224 if (OSRunning != OS STATE OS RUNNING) { 
// Return if multitasking has not started 
225 OS_CRITICAL EXIT(); 
226 return; 
227 } 
228 
229 OS CRITICAL EXIT NO SCHED(); 
230 
231 // 进行 任务 调度 
232 OSSched (); 
233 





大 致 浏览 下 这 个 函数 : 首先 对 参数 进行 检测 ， 然 后 对 任务 控制 块 等 进行 初始 化 ， 最 后 进行 任务 调度 。 部 分 细节 看 不 懂 没 有 关系 ， 因 为 涉及 的 内 容 
包括 任务 的 方方面面 ， 后 面 再 详细 讲解 这 些 相关 内 容 。 


15.2 ” 挂 起 任务 


函数 OSTaskSuspend 用 于 挂 起 任务 。 挂 起 的 合 义 相当 于 暂停 ， 即 剥夺 任务 的 CPU 使 用 权 。 可 以 多 次 调用 函数 OSTaskSuspend 对 任务 进行 挂 起 操 
作 ， 即 任务 挂 起 是 可 以 谋 套 的 ， 因 此 ， 想 要 将 任务 脱离 挂 起 状态 需要 调用 相应 次 数 的 OSTaskResume 函 数 。 除 空间 任务 和 延迟 提交 任务 外 ， 可 以 挂 
起 其 他 任何 任务 。 


函数 OSTaskSuspend 的 使 用 非常 简单 ， 即 只 要 输入 两 个 参数 ， 一 个 指向 要 挂 起 的 任务 的 指针 p_tcb， 一 个 指向 返回 错误 的 指针 p_err。 
返回 的 错误 主要 有 以 下 几 种 类 型 。 

. OS_ERR_NONE: 没有 错误 。 

* OS_ERR_SCHED_LOCKED: 调度 被 锁 住 了 ， 当 前 运行 任务 挂 起 后 不 能 进行 任务 调度 。 

. OS_ERR_TASK_SUSPEND_ISR: 在 中 断 中 调用 挂 起 任务 的 函数 。 

" OS_ERR_TASK_SUSPEND_IDLE: 挂 起 空闲 任务 。 

- OS_ERR_TASK_SUSPEND_INT_HANDLER: 挂 起 中 断 延 迟 任务 。 
任务 挂 起 函数 OSTaskSuspend 的 代码 见 代 码 清单 15-2。 


代码 清单 15-2 ”任务 挂 起 函数 OSTaskSuspend 





// 是 否 包含 挂 起 任务 或 者 取消 挂 起 任务 的 相关 代码 

#if OS CFG TASK SUSPEND EN > 0u 

void OSTaskSuspend (0S TCB *p tcb, 
OS ERR *p err) 





{ 
CPU_SR_ALLOC (); 


// 是 否定 义 安全 检查 的 宏 
#ifdef OS_SAFETY CRITICAL 
if (p err 一 (OS ERR *)0) { 
// 如 果 传 入 的 参数 Pp_err 是 空 指针 ， 那 么 将 进入 安全 关键 异常 ， 这 部 分 需要 用 户 自己 编写 
OS_SAFETY CRITICAL EXCEPTION(); 
return; 





} 
#endif 


// 中 断 中 不 允许 调用 任务 挂 起 函数 
#if OS CFG CALLED FROM ISR CHK EN > 0u 
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if (OSIntNestingCtr > (OS NESTING CTR) 0) { 
*p err = OS ERR TASK SUSPEND ISR; 
return; 





} 
#endif 


// 不 能 挂 起 空闲 任务 

if (p tcb == &OSIdleTaskTCB) { 
*p err = OS ERR TASK SUSPEND IDLE; 
return; 





} 


// 是 否 允 许 中 断 延 迟 提交 
#if OS_ CFG ISR POST DEFERRED EN > 0u 


// 如 果 挂 起 的 是 中 断 延迟 提交 任务 ， 则 返回 错误 
if (p tcb == &OSIntQTaskTCB) { 
*p err = OS ERR TASK SUSPEND INT HANDLER; 
return; 








} 
#endif 


// 进入 临界 段 
CPU_CRITICAL ENTER(); 


// 如 果 P_tcb 参 数 为 空 指 针 ， 则 默认 挂 起 的 是 当前 任务 
if tcb == (O08 ‘TCB *)0) 1 

p tcb = OSTCBCurPtr; 
} 


// 如 果 挂 起 的 是 当前 任务 ， 后 面 就 要 进行 任务 调度 ， 所 以 要 检查 调度 器 是 否 被 锁 住 


if (p tcb == OSTCBCurPtr) { 
if (OSSchedLockNestingCtr > (OS NESTING _CTR)0) { 
CPU_CRITICAL EXIT(); 
*p err = OS ERR SCHED LOCKED; 
return; 





} 
*p_err = OS ERR NONE; 


// 针对 挂 起 任务 的 不 同 状 态 进行 不 同 的 处 理 
switch (p tcb->TaskState) { 


// 就 绪 状 态 
Case OS_TASK STATE RDY: 


作 在 允许 中 断 延迟 的 情况 下 ， 开 中 断 并 且 锁 住 调度 器 ， 因 为 下 面 操作 的 变量 


ee 


延迟 ， 这 里 会 变 成 什么 都 不 做 ， 实 际 上 这 是 个 空 宏 ， 因 为 前 面 已 
OS_CRITICAL ENTER CPU CRITICAL EXIT(); 





// 任务 状态 变 为 挂 起 状态 
P_tcb->TaskState = OS _ TASK STATE SUSPENDED; 


// 挂 起 的 典 套 层 数 变 为 1， 之 前 没有 被 挂 起 
Pp_tcb->SuspendCtr = (OS NESTING CTR)1; 


// 将 任务 从 就 绪 列 表 中 脱离 
OS_RdyListRemove (p tcb); 


// 退出 临界 段 
OS CRITICAL EXIT NO SCHED(); 
break; 





// 延迟 状态 
case OS_TASK STATE DLY: 
P_tcb->TaskState = OS TASK STATE DLY SUSPENDED; 
p tcb->SuspendCtr = (OS NESTING CTR)1; 
CPU CRITICAL EXIT(); 
break; 


// 挂 起 的 状态 

case OS_TASK STATE PEND: 
P_tcb->TaskState = OS TASK STATE PEND SUSPENDED; 
P_ tcb->SuspenqaCtr = (OS NESTING CTR)1; 
CPU_CRITICAL EXIT(); 
break; 








// 正在 等 待 事件 发 生 ， 并 且 有 时 间 限 制 的 时 候 
// 注 : 0OS_ STATUS _PEND TIMEOUT 跟 OS_TASK_ STATE PEND TI 


过 
经 关中 断 * 


Su 








EOUT 的 含义 不 同 

















case OS TASK STATE PEND TIMEOUT : 
p_ tcb->TaskState = 
p_tcb->Suspengdctr = 
CPU_ CRITICAL EXIT(); 
break; 


OS TASK STATE PEND TIMEOUT S 
(OS_NESTING CTR)1; 








// 之 前 已 经 是 挂 起 状态 ， 只 需 将 谱 套 层 数 +1 

case OS TASK STATE SUSPENDED: 

case OS TASK STATE DLY SUSPENDED: 

case OS_ TASK STATE PEND SUSPENDED: 

Case OS TASK STATE PEND TIMEOUT SUSPENDED: 
Pp_tcb->SuspendCtr++; 
CPU_ CRITICAL EXIT(); 
break; 

















default: 





USPENDED; 


121 CPU_ CRITICAL EXIT(); 





122 *p err = OS ERR STATE INVALID; 
123 return; 

124 } 

125 

126 // 进行 任务 调度 

127 OSSched (); 

128 } 

129 #engdif 


具体 的 解析 查看 注释 即 可 ， 这 些 操作 跟 之 前 的 等 待 、 延 时 、 挂 起 等 操作 都 大 同 小 异 。 之 前 讲 过 的 所 有 关于 任务 的 操作 ， 包 括 等 待 、 延 时 、 挂 起 及 
其 组 合 ， 看 似 不 同 ， 实 际 就 是 剥夺 任务 的 CPU 使 用 权 ， 这 是 核心 的 东西 。 其 不 同 在 于 被 剥夺 的 CPU 使 用 权 和 恢复 CPU 使 用 权 的 情况 : 等 待 是 只 在 事件 
未 发 生 的 时 候 剥 夺 CPU 使 用 权 ， 一 旦 事件 发 生 就 恢复 CPU 使 用 权 ; 延 时 是 在 某 段 具 体 的 时 间 内 剥夺 CPU 使 用 权 ; 挂 起 就 是 在 用 户 调用 
OSTaskSuspend 和 OSTaskResume 之 间 这 段 时 间 内 剥夺 CPU 使 用 权 。 等 待 、 延 时 、 挂 起 及 其 组 合 这 些 操作 的 基础 都 是 任务 调度 ， 其 他 的 一 般 都 是 设 
置 任务 状态 ， 然 后 将 任务 插入 某 个 列表 。 任 务 延 时 的 时 候 需 要 检测 延 时 时 间 是 否 到 了 ， 如 果 到 了 ， 就 插入 延 时 列表 ; 等 待 需要 检测 时 间 是 否 发 生 ， 如 
果 发 生 就 插入 等 待 列表 。 而 挂 起 不 需要 插入 任何 列表 ， 因 为 任务 挂 起 后 ， 想 要 恢复 CPU 的 使 用 权 ， 不 用 检测 时 间 是 否 到 了 或 者 等 待 的 事件 发 生 ， 只 需 
在 调用 OSTaskResume 函 数 的 时 候 就 脱离 挂 起 的 状态 。 上 述 解析 应 该 能 够 帮助 读者 更 好 地 理解 这 些 操作 。 虽 然 等 待 、 延 时 、 挂 起 可 以 组 合成 多 种 情 
况 ， 但 是 ， 只 要 加 以 思考 ， 就 很 容易 知道 如 何 对 它们 进行 操作 。 比 如 想 要 在 任务 等 待 的 时 候 将 任务 挂 起 ， 由 于 系统 允许 等 待 的 时 候 挂 起 ， 之 前 等 待 时 
任务 已 经 被 剥夺 CPU 使 用 权 ， 插 入 等 待 列 表 ， 挂 起 又 不 用 插入 其 他 的 列表 ， 所 以 简单 地 将 任务 设置 为 状态 OS_TASK_STATE_PEND_SUSPENDED 后 
更 新 外套 的 层 数 即 可 。 


15.3 ”恢复 挂 起 任务 


函数 OsTaskResume 用 来 恢复 挂 起 任务 。 调 用 函数 OSTaskResume 也 只 需 输入 两 个 参数 : 一 个 是 指向 要 挂 起 的 任务 的 指针 p_tcb， 一 个 是 指向 返 
回 错误 的 指针 p_err。 被 恢复 的 任务 不 一 定 会 解除 挂 起 状态 。 挂 起 是 可 以 诗 套 的 ， 要 等 到 喉 套 层 数 为 0 的 时 候 才 会 解除 挂 起 状态 。 函 数 OSTaskResume 
的 具体 代码 见 代码 清单 15-3。 


代码 清单 15-3 ”恢复 挂 起 任务 函数 OSTaskResume 


// 是 否 包含 挂 起 任务 或 者 取消 挂 起 任务 的 相关 代码 
#if OS CFG TASK SUSPEND EN > 0u 

voiqd OSTaskResume (OS TCB *p tcb, 

OS ERR *p err) 





CPU_SR_ALLOC (); 


// 是 否定 义 安全 检查 的 宏 
#ifdef OS SAFETY CRITICAL 
if (p err == (OS ERR *)0) { 


// 如 果 传 入 的 参数 P_ err 是 空 指针 ， 那 么 将 进入 安全 关键 异常 ， 这 部 分 需要 用 户 自己 编写 
OS_SAFETY CRITICAL EXCEPTION(); 
return; 


} 
#endif 


// 中 断 中 不 允许 调用 任务 挂 起 函数 

20 #if OS CFG CALLED FROM ISR CHK EN > 0u 

21 if (OSIntNestingCtr > (OS NESTING CTR) 0) { 
22 *p err = OS ERR TASK RESUME ISR; 

23 return; 

24 } 

25 #engdif 
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27 // 进入 临界 段 
28 CPU_CRITICAL ENTER(); 


30 // 是 否 进 行 参 数 检测 
31 #if OS CFG ARG CHK EN > 0u 
32 /* 和 如 果 参 教 p tcb 是 空 指针 或 者 指向 当前 任务 的 指针 ， 那 么 不 能 继续 进行 恢复 操作 

















33 因为 当前 任务 正在 运行 ， 没 有 处 于 挂 起 状态 。*/ 
34 if ((p tcb == (0S TCB. *)0) || 

3 (p tceb == OSTCBCUrPtr)) 1 

36 CPU_ CRITICAL EXIT(); 

对 了 *p err = OS ERR TASK RESUME SELF; 
38 return; 

39 } 

40 #enqdif 

41 

42 *p err = OS ERR NONE; 

43 

44 // 根据 任务 的 状态 进行 操作 

45 switch (p tcb->TaskState) { 


47 // 如 果 任 务 没有 处 于 挂 起 的 相关 状态 ， 就 直接 退出 





















































48 case OS TASK STATE RDY: 
49 case OS _ TASK STATE DLY: 
50 case OS TASK STATE PEND: 
31 case OS TASK STATE PEND TIMEOUT: 
S52 CPU CRITICAL | EXIT (); 
33 *p err = OS ERR TASK NOT SUSPENDED; 
54 break; 
55 
56 // 如 果 任务 只 是 处 于 挂 起 状态 
57 Case OS_TASK STATE SUSPENDED: 
58 
59 // 开 中 断然 后 锁 住 调度 器 
60 OS CRITICAL ENTER CPU CRITICAL EXIT(); 
61 
62 // 挂 起 的 峰 套 层 数 减 ] 
63 p_tcb->SuspendCtr-—-—; 
64 
65 // 如 果 挂 起 的 肉 套 层 数 为 0， 那 么 就 将 任务 置 于 就 绪 状 态 
66 if (p tcb->SuspengdCtr == (OS _ NESTING CTR) 0) { 
67 p tcb->TaskState = OS_TASK STATE RDY; 
68 OS TaskRgdy (p tcb); 
69 } 
70 
71 // 减少 调度 器 诬 套 层 数 ， 即 退出 临界 段 
72 OS CRITICAL EXIT NO SCHED(); 
V3 break; 
74 
75 // 任务 处 于 延 时 和 挂 起 两 种 状态 
76 case OS_TASK_ STATE DLY SUSPENDED: 
TE 
78 // 挂 起 的 谋 套 层 数 减 ] 
79 Pp tcb->SuspendCtr——; 
80 
81 // 如 果 嵌 套 层 数 已 经 为 0， 说 明 已 经 脱离 挂 起 状态 ， 剩 下 等 待 状态 
82 站 ee == (OS NESTING CTR) 0) { 
83 p tcb->TaskState = OS_ TASK STATE DLY; 
84 } 
85 
86 // 退出 临界 段 
87 CPU CRITICAL EXIT(); 
88 break; 
89 
90 /* 任 务 处 于 挂 起 和 等 待 两 种 状态 ,仍然 是 先 将 谋 套 层 数 减 1， 然 后 检查 
91 挂 起 能 套 的 层 数 是 否 为 0， 为 0 就 只 剩 下 等 待 状态 了 */ 
92 case OS TASK STATE PEND SUSPENDED: 
93 P tcb->SuspendCtr-——; 
94 if (p tcb->SuspengdCtr == (OS NESTING CTR) 0) { 
95 p tcb->TaskState = OS _ TASK STATE PEND; 
96 } 
7 CPU _ CRITICAL EXIT(); 
98 break; 
99 
100 /* 任 务 处 于 挂 起 和 超时 等 待 两 种 状态 ,仍然 是 先 将 谋 套 层 数 减 1， 然 后 检查 
L101 挂 起 座 套 的 层 数 是 否 为 0， 为 0 就 只 剩 下 超时 等 待 状态 了 */ 
102 Case OS TASK STATE PEND TIMEOUT SUSPENDED: 
103 p_ tcb->Suspengdctr-——; 
104 if (p tcb->SuspendCtr == (OS NESTING CTR) 0) { 
105 p tcb->TaskState = OS _ TASK STATE PEND TIMEOUT; 
106 } 
107 CPU_ CRITICAL EXIT(); 
108 break; 
109 
i110 default: 
和 CPU_ CRITICAL EXIT () 7 
112 *p err = OS ERR STATE INVALID; 
113 return; 
114 } 
115 
116 // 进行 任务 调度 
i117 OSSched (); 
118 
119 #engdif 











恢复 任务 挂 起 状态 的 过 程 也 是 非常 简单 的 。 首 先 检测 到 任务 必须 是 处 于 挂 起 状态 ， 接 着 将 挂 起 的 嵌 套 层 数 减 1 后 判断 是 否 已 经 完全 脱离 挂 起 状 
态 。 刻 套 层 数 放 在 任务 控制 块 的 元 素 SuspendCtr 中 。 如 果 没 有 完全 脱离 挂 起 状态 就 不 用 改变 任务 的 状态 ， 如 果 完 全 脱离 挂 起 状态 ， 那 么 将 任务 状态 
改 为 没有 挂 起 的 状态 。 比 如 处 于 延 时 挂 起 在 的 任务 脱离 挂 起 状态 后 ， 就 是 处 于 等 待 状态 。 


轮转 调度 





HC/OS-Ill 引 进 了 时 间 片 轮转 调度 。 时 间 片 轮转 调度 是 多 个 任务 根据 其 之 前 分 配 的 好 的 时 间 片 数量 进行 运行 ， 时 间 片 越 多 ， 运 行 时 间 越 长 。 时 间 
片 用 完 后 交 出 CPU 使 用 权 给 下 一 个 拥有 时 间 片 的 任务 。 之 所 以 叫 时 间 片 轮转 调度 ， 大 家 看 看 图 15-1 实 践 片 轮转 调度 示意 图 应 该 就 可 以 理解 : 几 个 优先 
级 相同 的 任务 轮流 占用 CPU， 周 而 复 始 ， 占 用 CPU 的 时 间 就 是 设置 的 时 间 片 长 度 。 注 意 这 些 任务 的 优先 级 必须 是 相同 的 。 





图 15-1 实践 片 轮转 调度 示意 图 


15.5 “任务 寄存 器 


任务 寄存 器 对 于 部 分 读者 可 能 会 比较 新 奇 ， 但 其 实 它 实现 起 来 非常 简单 。 像 更 常见 的 用 来 存放 数据 、 地 址 、 指 令 的 寄存 器 一 样 ， 任 务 寡 存 器 可 以 
用 来 给 用 户 存 放 一 些 任务 相关 的 数据 。 任 务 寄存 器 就 是 在 任务 控制 块 的 数据 结构 中 增加 的 一 个 数组 ， 用 来 存放 这 些 变量 。 用 户 可 以 通过 设置 
OS_CFG_TASK_REG_TBL_SIZE 的 值 来 设置 任务 寄存 器 的 个 数 ， 所 有 任务 的 任务 寄存 器 个 数 都 是 由 这 个 值 决定 的 。 在 我 们 的 例 程 中 任务 寄存 器 的 类 型 


是 32 位 无 符号 整形 。 在 创建 任务 的 时 候 会 将 其 全 部 置 0。 


15.6 忆 结 


本 章 主要 讲解 了 任务 的 创建 、 挂 起 任务 、 取 消 挂 起 任务 等 操作 以 及 时 间 片 轮转 调度 的 原理 。 任 务 的 创建 代码 很 长 ， 主 要 分 为 参数 检测 ， 任 务 控制 


块 的 初始 化 ， 任 务 调度 等 等 。 挂 起 任务 和 取消 挂 起 任务 两 个 过 程 实现 起 来 很 简单 ， 因 为 任务 挂 起 和 取消 挂 起 是 程序 员 决 定 的 ， 不 需要 有 等 待 列 表 、 节 
拍 列表 等 来 管理 挂 起 的 任务 。 


通过 本 章 对 时 间 片 轮转 调度 代码 的 解析 ， 我 们 可 以 知道 时 钟 节拍 为 时 间 片 的 查询 提供 了 一 个 时 间 的 基准 ， 每 个 时 钟 节拍 到 来 就 将 当前 运行 任务 的 
时 间 片 减 1， 减 到 0 就 是 时 间 片 耗 尽 了 。 就 绪 列表 的 数据 结构 也 为 实现 时 间 片 轮转 调度 提供 了 方便 。 时 间 片 轮转 调度 的 时 候 ， 将 时 间 片 耗 尽 的 任务 移 到 
该 优先 级 就 绪 列 表 的 最 后 ， 然 后 取出 下 一 个 任务 继续 运行 。 由 于 uC/OS-lll 数 据 结构 有 良好 的 设计 ， 这 些 的 实现 都 是 轻而易举 的 事情 。 正 如 这 个 调度 
算法 的 名 字 ， 同 一 个 优先 级 上 的 任务 就 像 轮 子 一 样 不 断 的 循环 反复 地 运行 。 


第 16 章 ”中断 管 理 


中 断 在 一 个 系统 中 相当 于 一 个 优先 级 最 高 的 任务 ， 对 中 断 处 理 的 主要 原则 是 中 断 比较 紧急 而 且 运行 时 间 比 较 短 。 本 章 讲解 的 中 断 管理 主要 涉及 中 
断 延 迟 提 交 、 中 断 谋 套 管理 、 开 关中 断 、 关 中 断 时 间 测 量 等 。 


16.1 ”中断 延 迟 提交 


根据 用 户 对 宏 OS_CFG_ISR_POST_DEFERRED_EN 配 置 进入 和 退出 临界 段 可 分 为 使 用 和 不 使 用 中 断 延 时 两 种 。 不 使 用 中 断 延 迟 进入 临界 段 的 方式 
是 关中 断 ， 使 用 中 断 延 迟 进入 临界 段 的 方式 可 以 是 关中 断 或 者 锁 调 度 器 。 有 些 变量 不 可 能 在 中 断 中 被 访问 ， 所 以 只 要 保证 其 他 任务 不 使 用 这 些 变量 即 
可 。 这 时 就 可 以 用 锁 调 度 器 进入 的 方式 。 用 锁 调 度 器 代替 关中 断 ， 大 大 节省 了 关中 断 的 时 间 。 


这 里 中 断 延 迟 的 意义 主要 体现 在 ， 中 断 中 如 果 使 用 相关 的 提交 函数 ,例如 OSSemPost、OSQPost 等 ， 则 这 些 函数 涉及 让 任务 就 绪 等 操作 。 如 果 
没有 使 用 中 断 延 迟 ， 则 进入 一 段 很 长 的 临界 段 ， 也 就 是 要 关中 断 很 长 时 间 。 如 果 使 用 中 断 延 迟 ，OS 就 会 将 这 些 提交 函数 必要 的 信息 保存 到 中 断 延 迟 
是 交 的 变量 中 去 。 为 了 配合 中 断 延 迟 ，hC/OS-l 川 还 将 创建 优先 级 最 高 (优先 级 为 0) 的 任务 一 一 中 断 提 交通 数 OS_IntQTask。 退 出 中 断后 根据 之 前 
保存 的 参数 ， 后 面 再 次 进行 提交 相关 操作 。 这 个 过 程 其 实 就 是 把 中 断 中 的 临界 段 放 到 任务 中 来 实现 ， 进 入 临界 段 就 可 以 采用 锁 调 度 器 的 方式 代替 关中 
断 ， 因 此 大 大 减少 了 关中 断 的 时 间 。 提 交 操 作 延 迟 一 一 中 断 延 迟 就 是 这 么 来 的 。 





注意 : 内 核 函 数 为 了 保证 其 操作 的 完整 性 ， 都 会 进入 或 长 或 短 的 临界 段 ， 所 以 在 中 断 中 要 尽量 少 调用 内 核 函数 ， 部 分 HC/OSs- 吊 提供 的 函数 是 不 
人 允许 在 中 断 中 调用 的 。 


中 断 延 迟 提交 将 较 长 的 提交 过 程 转移 到 优先 级 最 高 的 中 断 延 迟 提交 任务 ， 提 交 的 过 程 就 可 以 采用 关 调 度 器 的 方式 ， 而 不 用 关中 断 ， 因 而 节省 了 关 
中 断 的 时 间 。 但 是 整个 过 程 并 不 影响 提交 的 效果 。 我 们 已 经 设 定 中 断 延 迟 提交 任务 的 优先 级 为 最 高 ， 在 退出 中 断后 一 样 会 进行 提交 操作 。 
Os IntQPost 这 个 函数 我 们 已 经 不 陌生 ， 前 面 在 介绍 内 核对 象 的 提交 过 程 都 有 出 现 ， 现 在 我 们 统一 放 到 这 里 来 讲解 。 


16.2 ”中断 嵌 套 管理 


中 断 谋 套 管理 函数 OslntEnter 和 OsSlntExit 的 源码 如 代码 清单 16-5 和 代码 清单 16-6 所 示 。 在 进入 中 断 和 退出 中 断 的 时 候 要 进行 调用 ， 以 免 造 成 系 
统 出 错 。 


代码 清单 16-5 中断 嵌 套 管理 函数 OSIntEnter 


void OSIntEnter (void) 
{ // 确定 系统 已 经 在 运行 
if (OSRunning != OS _ STATE OS RUNNING) { 
returns 


// 如 果 嵌 套 层 数 不 超过 250 层 
if (OSIntNestingCtr >= (OS NESTING CTR)250u) { 


1 
2 
3 
4 
与 
6 
到 
8 return; 


9 } 
10 
11 OSIntNestingCtr++; 
过 下 





函数 OslntEnter 首 先 检测 系统 是 否 在 运行 。 加 入 这 个 检测 的 原因 是 ， 在 系统 还 没有 运行 之 前 产生 中 断 要 回 到 任务 还 会 进行 任务 切换 。 系 统 还 没有 
运行 就 进行 任务 切换 ， 可 能 会 导致 系统 崩 演 。 所 以 中 断 初始 化 通常 放 在 首 个 任务 开始 执行 的 地 方 。 如 果 限定 谋 套 层 数 不 超过 250 层 ， 则 最 后 把 
OSIntNestingCtr 加 1。 更 直接 的 办 法 是 进入 中 断 服务 函数 时 将 OSIntNestingCtr 加 1， 前 提 是 能 保证 没有 前 面 的 检验 也 不 会 有 问题 。 


代码 清单 16-6 ”退出 中 断 函 数 OslIntExit 











1 void OSIntExit (void) 
2 { 
3 // 分 配 保存 中 断 状态 的 局 部 变量 ， 后 面 关 中 断 的 时 候 可 以 保存 中 断 状 态 
4 CPU SR_ALLOC () 
5 
6 
7 // 判断 系统 是 否 在 运行 
8 if (OSRunning != OS _ STATE OS RUNNING) { 
9 return; 
10 } 
11 // 关中 断 
12 CPU_INT DIS(); 
3 if (OSIntNestingCtr == (OS_NESTING CTR) 0) { 
14 CPU_INT EN(); 
上 上 人 return; 
16 } 
17 // 中 断 谋 套 层 数 减 1 
18 OsIntNestingCtr-—-; 
19 // 如 果 还 有 中 断 在 进行 ， 则 返回 上 一 级 中 断 
20 if (OSIntNestingCtr > (OS NESTING CTR) 0) { 
21 CPU_INT EN(); 
2 return; 
23 } 
24 // 退出 中 断后 可 能 要 让 更 高 优先 级 的 任务 就 绪 ， 这 时 检测 调度 器 是 否 被 锁 住 
25 if (OSSchedLockNestingCtr > (OS NESTING CTR)0) { 
26 CPU_INT EN(); 
27 return; 
28 } 
29 // 找到 优先 级 最 高 的 任务 
30 OSPrioHighRdy = OS PrioGetHighest (); 
31 OSTCBHighRAyPtr = OSRdyList[OSPrioHighRdy] .HeadPptr; 
32 /* 判 断 是 否 跟 进入 中 断 之 前 的 任务 一 样 ， 如 果 一 样 ， 
33 直接 退出 中 断 ， 返 回 原来 的 任务 即 可 。*/ 
34 if (OSTCBHighRdyPtr == OSTCBCurPtr) { 
39 CPU_INT EN(); 
36 return; 
37 


38 // 如 果 入 许 测量 统计 信息 
39 #if OS CFG TASK PROFTIE EN > 0u 
40 // 将 该 任务 控制 块 中 记录 切换 次 数 CtxSwCtr 的 元 素 加 1 





41 OSTCBHighRAdyPtr->CtxSwCtrt++; 

42 #endif 

43 // 将 记录 总 任务 切换 次 数 的 变量 OSTaskCtxSwCtr 加 1 
44 OSTaskCtxSwCtr++; 

45 // 切换 到 更 高 的 优先 级 

46 OSIntCtxSw (); 

47 // 开 中 断 

48 CPU_INT EN(); 

49 } 


退出 中 断 的 时 候 要 调用 函数 OslntExit。 该 函数 首先 检测 系统 有 没有 在 运行 ， 再 关中 断 进入 临界 段 。 接 着 继续 判断 中 断 谋 套 是 否 是 0 层 ， 如 果 是 0 
层 ,， 说 明 没有 进入 中 断 ， 就 不 退出 ， 直 接 返 回 。 然 后 嵌 套 层 数 OSIntNestingCtr 减 1， 再 判断 是 否 完全 退出 所 有 的 中 断 及 中 断 嵌 套 。 如 果 完全 退出 中 
断 嵌 套 ， 就 将 进入 中 断 之 前 的 任务 优先 级 跟 就 绪 任 务 中 最 高 的 优先 级 进行 比较 : ya 就 直接 返回 继续 运行 任务 ; 如 果 后 者 比较 高 ， 就 进 
行 任务 切换 。 中 间 还 更 新 了 任务 切换 的 次 数 。 如 果 还 没有 完全 退出 中 断 嵌 套 ， 还 有 另 一 层 中 断 ， 这 就 涉及 咬 尾 中 断 的 相关 知识 。 


16.3 ” 开 中 断 和 关中 断 解析 


代码 清单 16-7 是 开关 中 断 的 宏 的 代码 。 


代码 清单 16-7 开关 中 断 的 宏 





// 是 否 要 测量 最 大 关中 断 时 间 
#ifdef CPU CFG INT DIS MEAS EN 


// 关中 断 
#define CPU _ CRITICAL ENTER() do { CPU INT DIS(); 














ORODP 





CPU IntDisMeasStart(); } while (0) 


// 开 中 断 
define CPU _ CRITICAL EXIT () do { CPU IntDisMeasStop(); \ 
10 CPU_INT EN(); } while (0) 


12 #else 


14 // 关中 断 
15 #define CPU CRITICAL ENTER() do { CPU INT DIS(); } while (0) 
16 // 开 中 断 
17 #define CPU CRITICAL EXIT() do { CPU INT EN(); } while (0) 








19 #endif 





开关 中 断 的 宏 中 可 以 设 定 是 否 开启 关中 断 最 大 时 间 测 量 的 功能 。 开 启 关 中 断 最 大 时 间 测 量 功能 的 时 候 ， 进 入 中 断 由 函数 CPU_lntDisMeasStart 判 
断 ， 如 果 是 第 一 级 中 断 ， 则 开始 进行 关中 断 最 大 时 间 测 量 ; 退出 中 断 的 时 候 由 函数 CPU_IntDisMeasStop 判 断 ， 如 果 是 ， 则 退出 最 后 一 级 中 断 停止 测 
面 会 详细 讲解 。 无 论 是 否 带 关 中 断 最 大 时 间 测 量 功能 ， 开 中 断 和 关中 断 的 宏 又 都 调用 了 CPU_INT_EN 和 CPU_INT_DIS 两 个 安 。 这 两 个 宏 的 定 

义 如 代码 清单 16-8 所 示 。 


代码 清单 16-8 开关 中 断 又 一 层 宏 





1 #define CPU INT DIS () do { cpu sr = CPU SR Save(); } while (0) 
2 #define CPU INT EN() do { CPU SR Restore(cpu sr); } while (0) 





CPU_SR_save 和 CPU_SR_Restore 是 两 个 定义 在 汇编 文件 cpu_a.asm 中 的 函数 ， 如 代码 清单 16-9 所 示 。 


代码 清单 16-9 ”开关 中 断 底层 汇编 函数 





1 CPU SR Save 7 保存 关中 断 前 的 状态 并 关中 断 

2 MRS ~ RO, PRIMASK ;保存 关中 断 前 的 全 局 中 断 状态 

3 CPSID I ;关中 断 

4 BX LR ;程序 返回 

5 

6 

7 CPU SR Restore ;恢复 关中 断 前 的 状态 

8 MSR PRIMASK, RO ;将 RO0 中 参数 的 值 赋 给 PRIMASK 寄 存 器 
9 BX LR ;程序 返回 





汇编 语言 的 相关 知识 可 以 参考 《Cortex-M3 权 威 指南 》 一 书 。 


MRs 指 令 的 功能 如 图 16-3 所 示 。 


MRS <Rn>， <SReg> ; 加 载 特殊 功能 寄存 器 的 值 到 Rn 


MSR <Sreg>,<Rn> ;和 存储 Rn 的 值 到 特殊 功能 寄存 蜗 


图 16-3 ”MRS 指令 的 功能 





《Cortex-M3 权 威 指南 》 对 PRIMASK 这 个 寄存 器 的 解释 如 图 16-4 所 示 。 





图 16-4 PRIMAS 区 寄存 器 的 含义 


上 面 提 到 了 异常 ， 简 单 地 讲 ， 之 前 理解 的 中 断 即 是 这 里 的 异常 。 下 面 同样 用 《Cortex-M3 权 威 指南 》 这 本 书 中 的 译注 部 分 来 为 大 家 解释 中 断 和 异 
常 的 区 别 ， 如 图 16-5 所 示 。 本 书后 面 不 区 分 异常 和 中 断 。 


所 有 能 JT 和 自家 币 执 行 流 的 事 侍 什 都 称 为 下 证 - 常 在 本 书 中 经 常 混合 使 用 术语 “中 源 [与 民 过 如 
不 加 说 明 ， 则 好 pe 都 是 它们 对 主 程序 所 入 现 ， 来 的 “中 断 ” 人 性质， 与 我 们 以 前 * 多 片 机 时 所 讲 的 概 
念 是 相同 的 。 如果 非得 分 个 丁 一 孵 二 ， 则 中 断 与 异常 的 区 别 在 于 ， 那 240 个 中 断 对 CM3 核 来 说 都 是 “ 


意外 突 发 事件 ” 也 就 是 说 ， 该 请 求 信 号 pid 内 核 的 外 而 面 ， 来 自 各 种 片上 外 设 和 外 扩 的 外 设 
对 CM3 来 说 是 “异步 ”的 ; 而 并 常 则 是 因 CM3 内 核 的 活动 产生 的 在 执行 指令 或 访问 存储 器 时 产 
生 ， 因此 对 CM3 来 说 是 和 同 步 ” 的 








图 16-5 ”异常 和 中 断 


所 以 代码 清单 16-9 中 的 第 2 行 是 说 我 们 将 PRIMASK 的 值 赋 给 RO0。 这 里 有 几 个 问题 : @ 为 什么 是 R0? 可 不 可 以 是 其 他 的 寄存 器 ?”@ 为 什么 要 将 
PRIMASK 的 值 赋 给 RO? 


第 一 个 问题 涉及 汇编 和 C 的 混合 编程 ， 在 代码 清单 16-8 中 是 C 语 言 调用 了 汇编 函数 。 这 里 有 规定 ，32 位 的 返回 值 存放 在 RO0，64 位 的 返回 值 在 r0 存 
放 低 32 位 ， 在 r1 存 放 高 32 位 。 到 这 里 读者 即 可 知道 第 2 行 的 用 意 就 在 于 将 PRIMASK 这 个 特殊 功能 寄存 器 的 值 返回 放 到 接收 返回 值 的 变量 cpu_sr 中 去 。 
这 是 为 了 保存 中 断 之 前 的 全 局 中 断 的 开关 状态 。 


第 3 行 CPSIDI 是 Cortex-M3 内 核 的 一 条 关 全 局 中 断 的 指令 。 


第 4 行 中 的 BX 的 用 法 如 下 。 





BX reg ; 跳 转 到 由 寄存 器 reg 给 出 的 地 址 





第 4 行 的 意思 就 是 跳 转 到 LR 给 出 的 地 址 ， 前 面 在 介绍 调用 函数 之 前 ，LR 保 存 了 调用 函数 之 前 的 下 一 条 指令 的 地 址 。 所 以 第 4 行 的 意思 就 是 子 程序 
返回 的 意思 。 


第 7~9 行 是 恢复 关中 断 前 的 状态 〈 注 意 前 面 说 的 开 中 断 并 不 完全 准确 ) ， 同 理 第 8 行 代表 将 RO 寄存 器 的 值 赋 给 特殊 寄存 器 PRIMASK。 为 什么 这 里 
是 RO 寄存 器 ? RO 寄存 器 中 存放 的 是 什么 ? 不 知道 大 家 有 没有 注意 到 代码 清单 16-8 中 第 2 行 调 用 CPU_SR_Restore 的 时 候 传 递 了 一 个 参数 cpu_sr 进 去 ， 
这 个 参数 cpu_sr 最 后 赋 给 了 R0。 为 什么 呢 ?” 因 为 C 语 言 环 境 调用 汇编 语言 的 时 候 ， 参 数 传递 满足 这 样 的 规则 : 当 参 数 少 于 四 个 时 ， 按 从 左 到 右 的 顺序 
依次 存放 在 r0、r1、r2、r3 中 ; 当 参 数 多 于 四 个 时 ， 前 四 个 放 在 r0、r1、r2、r3 中 ， 剩 余 的 放 在 堆栈 中 ， 最 后 一 个 参数 先入 栈 ， 第 五 个 参数 最 后 入 
栈 ， 即 从 右 到 左 入 栈 。 


这 里 还 有 一 个 问题 ，cpu_sr 到 底 是 什么 ”什么 时 候 出 现在 程序 中 的 ?可 能 有 的 读者 已 经 观察 到 每 次 关中 断 的 时 候 ， 前 面 都 会 有 下 面 这 句 话 。 


CPU_SR ALLOC () ; 


跟踪 其 定义 。 


CPU _SR_RALLOC () CPU SR cpu sr = (CPU SR)0 











也 就 是 说 ，CPU_SR_ALLOC 就 是 定义 了 局 部 变量 cpu_sr， 这 个 变量 的 作用 就 是 在 关中 断 之 前 保存 了 全 局 中 断 是 关 还 是 开 ， 再 根据 这 个 变量 来 确 
定 全 局 中 断 是 应 该 关 还 是 开 着 。 


这 样 整个 过 程 就 很 清晰 了 ， 在 关中 断 之 前 我 们 先 定义 了 一 个 局 部 变量 cpu_sr， 关 中 断 时 将 中 断 的 开关 状态 保存 到 这 个 局 部 变量 中 ， 然 后 在 开 中 断 
时 根据 cpu_sr 的 值 恢复 开关 中 断 的 状态 。 在 不 同 的 CPU 及 编译 环境 下 ， 还 可 以 有 其 他 不 同 开关 中 断 的 方式 。 比 如 有 的 将 关中 断 之 前 中 断 开 关 的 状态 弹 
进 栈 ， 有 的 干脆 不 保存 中 断 开关 状态 。 当 然 在 进入 临界 段 之 前 ， 中 断 如 果 是 关 ， 出 了 临界 段 后 中 断 就 是 开 了 。 


16.4 ”进入 和 退出 临界 段 代码 解析 


代码 清单 16-10 是 退出 和 进入 临界 段 的 代码 。 


代码 清单 16-10 ”使 能 中 断 延 迟 进入 和 退出 临界 段 的 代码 
















































































1 #define OS CRITICAL ENTER () 
2 do { 
3 CPU _ CRITICAL ENTER(); 
4 OSSchedLockNestingCtr++; 
过 if (OSSchedLockNestingCtr == 1u) { 
6 OS SCHED LOCK TIME MEAS START(); 
7 } 
8 CPU CRITICAL EXIT () ; 
9 } while (0) 
10 
11 #define OS CRITICAL ENTER CPU CRITICAL EXIT() 
12 do { 
13 OSschedLockNestingCtr++; 
14 
1 导 if (OSSchedLockNestingCtr == 1u) { 
16 OS SCHED LOCK TIME MEAS START(); 
1 } 
18 CPU CRITICAL EXIT(); 
19 } while (0) 
之 人 
21 
22 #define OS CRITICAL EXIT() 
23. do { 
24 CPU_ CRITICAL ENTER(); 
25 OSschedLockNestingCtr-—-; 
26 if (OSSchedLockNestingCtr == (OS NESTING CTR)0) { 
27 OS_SCHED LOCK TIME MEAS STOP(); 
28 if (OSIntQNbrEntries > (OS OBJ QTY)0) { 
29 CPU CRITICAL EXIT(); 
30 OS_Scheqg0 (); 
1 } else { 
32 CPU CRITICAL EXIT(); 
33 } 
34 } else { 
35 CPU CRITICAL EXIT(); 
36 } 
3 } while (0) 
38 
39 #define OS CRITICAL EXIT NO SCHED() 
40 go { 
41 CPU_CRITICAL ENTER(); 
42 OSschedLockNestingCtr-—-; 
43 if (OSSchedLockNestingCtr == (OS NESTING CTR)0) { 
44 OS_SCHED LOCK TIME MEAS STOP(); 和 
45 } 
46 CPU CRITICAL EXIT () ， 
47 } while (0) 加 


16.5 ”测量 关中 出 








关中 断 时 间 是 一 个 很 重要 的 参数 ， 因 此 NhC/OS- 吊 在 测量 关中 断 的 时 间 上 下 了 很 大 功夫 。 


16.6 忆 结 


本 章 依次 介绍 了 中 断 延 迟 提交 、 中 断 谋 套 管理 、 开 关中 断 、 进 入 临界 段 的 方式 以 及 测量 关中 断 的 最 大 时 间 。 


如 果 使 能 了 中 断 延 迟 提交 ， 在 中 断 中 要 提交 某 个 内 核对 象 ， 首 先 会 将 提交 的 信息 保存 在 延迟 提交 信息 队列 中 ， 并 且 让 延迟 提交 任务 就 绪 。 退 出 中 
断后 进入 延迟 提交 任务 ， 延 迟 提交 从 延迟 提交 信息 队列 中 取出 相关 的 信息 进行 内 核对 象 的 提交 。 后 面 的 提交 过 程 是 在 任务 中 进行 的 ， 不 用 关中 断 ， 锁 
住 调度 器 即 可 。 


后 面 介绍 了 测量 最 大 关中 断 时 间 的 过 程 ， 不 管 是 这 个 程序 运行 过 程 的 最 大 关中 断 时 间 还 是 一 段 时 间 的 最 大 关中 断 时 间 ， 都 可 以 进行 测量 。 为 了 让 
测量 更 加 准确 ， 在 初始 化 的 时 候 还 计算 了 测量 一 次 需要 的 时 间 ， 除 去 这 部 分 时 间 ， 我 们 会 得 到 更 加 准确 的 最 大 关中 断 时 间 。 图 16-6 是 通过 测量 11 个 
例 程 在 开启 中 断 延 迟 提 交 和 不 开启 中 断 延 迟 提 交 的 情况 下 分 别 测量 最 大 关中 断 的 时 间 做 成 的 图 ， 从 图 中 可 以 看 到 开启 中 断 延 迟 提 交 后 最 大 关中 断 时 间 
缩短 了 3 ， 并 且 在 不 同 的 例 程 中 波动 不 大 。 
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图 16-6 ”中 断 延 迟 提交 与 否 的 最 大 关中 断 时 间 对 比 


第 17 章 ”各 类 统计 信息 


为 了 方便 用 户 了 解 ，HC/OS- 员 提供 了 很 多 各 类 系统 运行 时 的 统计 信息 。 前 面 介 绍 过 的 最 大 关中 断 时 间 及 各 内 核对 象 的 调试 列表 就 是 其 中 的 两 种 
统计 信息 。 本 章 要 讲解 的 是 CPU 使 用 率 和 堆栈 检测 。 


17.1 实例 演示 


图 17-1 是 在 野火 STM32 开 发 板 3.2 寸 液晶 显示 屏 上 实时 显示 CPU 使 用 率 的 情况 。 从 图 中 可 以 看 到 两 个 任务 ， 一 个 是 图 形 用 户 界面 绘制 任务 ， 一 个 
是 串口 接收 任务 。 为 了 达到 图 形 周期 性 变化 的 效果 ， 我 们 需要 在 串口 助手 中 设置 以 一 定 频率 发 送 串 口 数据 给 STM32 攻 片 ， 当 串口 接收 到 数据 并 在 串 
口 打印 出 来 的 时 候 就 会 加 大 CPU 占用 率 ， 否 则 就 没有 图 中 波形 周期 性 变化 的 效果 。 


图 17-2 是 在 野火 STM32 开 发 板 液晶 显示 屏 上 显示 堆栈 的 使 用 情况 。 


图 17-1 CPU 占用 率 测 量 演示 
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图 17-2 ”堆栈 检测 演示 


17.2 CPU 使 用 率 计 算 





平时 使 用 计算 机 的 时 候 ， 我 们 有 时 也 会 关注 CPU 的 使 用 率 ，hC/OS- 吊 也 提供 程序 运行 时 CPU 的 使 用 率 。 相 信 大 家 很 好 奇 CPU 的 使 用 率 是 怎么 计 
算出 来 的 。 首 先 必须 调用 函数 OSSstatTaskCPUUsagelnit 进 行 初始 化 ， 这 个 初始 化 对 CPU 使 用 率 的 计算 至 关 重 要 。 在 这 个 函数 中 ， 会 单纯 地 执行 空闲 
任务 一 段 固定 的 时 间 T， 空 闲 任务 其 实 就 是 在 一 个 死 循 环 中 不 断 地 给 一 些 变量 做 加 法 。 可 以 说 ，hC/OS- 员 没事 时 就 进入 空闲 任务 做 算术 题 ， 在 执行 函 
数 OSStatTaskCPUUsagelnit 的 时 候 不 执行 其 他 的 任务 ， 专 门 在 循环 中 给 OSStatTaskCtr 做 加 法 ， 看 看 在 这 段 给 定 的 时 间 T 内 最 大 的 计数 可 以 达到 多 
大 ， 并 记录 在 变量 OSStatTaskCtrMax 中 验证 到 的 值 是 109231， 这 个 值 主要 由 CPU 运行 指令 的 速度 决定 。 接 着 正常 运行 其 他 任务 ， 开 始 之 前 先 将 
OSStatTaskCtr 清 0， 每 隔 一 段 时 间 T， 统 计 任 务 就 会 根据 OSStatTaskCtr 算 出 CPU 的 使 用 率 ， 计 算 的 公式 是 CPUUsage (%) =100* (1- 
OsSsStatTaskCtr/OSStatTaskCtrMax) ， 即 空闲 任务 运行 死 循 环 的 循环 次 数 就 是 在 时 间 T 内 CPU 空闲 的 程度 。 璧 如 ， 当 OSsstatTaskCtr 的 值 与 
OsstatTaskCtrMax 的 值 都 为 109231 时 ， 说 明 CPU 一 直 没 有 运行 其 他 任务 ， 一 直 在 空闲 任务 中 ，CPU 使 用 率 自然 是 0%， 通 过 计算 也 可 得 到 这 个 值 。 
如 果 OSsstatTaskCtr 的 计数 值 为 0， 说 明 CPU 在 时 间 T 内 没有 进入 空闲 任务 中 ，CPU 使 用 率 自然 是 100%。CPU 使 用 率 的 计算 过 程 还 是 比较 简单 的 。 一 
般 情况 下 ， 时 间 T 由 OSCfg_StatTaskRate_Hz 决 定 ， 在 例 程 中 这 个 值 是 10， 这 个 值 决定 了 统计 任务 的 执行 频率 ， 即 更 新 一 次 CPU 使 用 率 的 时 间 为 
1/OSCfg_StatTaskRate_Hz， 单 位 是 秒 。 需 要 注意 的 小 细节 是 ， 由 于 OSCfg_StatTaskRate_Hz 是 在 时 钟 节拍 的 基础 上 分 频 得 到 的 ， 如 果 统 计 任务 运 
行 的 频率 设 定 不 是 时 钟 节拍 的 整数 倍 ， 那 么 统计 任务 实际 运行 的 频率 跟 设 定 的 就 有 些许 人 为 误差 ， 这 点 跟 定时 器 是 一 样 的。 如果 
OSCfg_StatTaskRate_Hz 的 频率 小 于 时 钟 节拍 的 频率 ， 那 么 统计 任务 执行 的 频率 由 uC/OS 设 定 为 时 钟 节拍 的 1/10。 默 认 OSCfg_StatTaskRate_Hz 为 
统计 任务 执行 的 频率 ， 后 面 不 再 具体 说 出 另外 的 两 种 情况 ， 请 读者 注意 。 

















17.3 CPU 使 用 率 测量 的 初始 化 


在 获取 CPU 使 用 率 之 前 必须 先进 行 初始 化 并 且 有 一 定 限制 条 件 。 前 面 提 及 调用 OSSstatTaskCPUUsagelnit 的 时 候 ， 只 有 空闲 任务 在 不 断 地 给 
OSstatTaskCtr 做 加 法 ， 这 就 是 限制 条 件 。 在 调用 OSsstatTaskCPUUsagelnit 的 时 候 ， 一 定 只 有 空闲 任务 在 运行 。 现 在 想 测 测 在 只 有 空闲 任务 运行 时 
可 以 进行 多 少 次 循环 ， 如 果 不 止 空闲 任务 在 运行 ， 那 么 CPU 实际 上 是 不 会 完全 被 空闲 任务 占用 的 ， 而 是 会 被 那些 优先 级 比 空闲 任务 高 的 占用 ， 测 得 的 
OSStatTaskCtrMax 就 会 偏 小 。 一 种 错误 的 初始 化 就 是 先 创建 多 个 任务 ， 然 后 再 统计 任务 的 初始 化 ， 创 建 完 多 个 任务 后 ， 很 难保 证 在 前 面 说 到 的 
1/OSCfg_StatTaskRate_Hz 秒 内 只 有 空闲 任务 在 运行 ， 空 闪 任 务 的 优先 级 又 是 最 低 的 。 所 以 XC/OS-ll| 一 般 会 先 初始 化 系统 ， 创 建 一 个 任务 ， 接 着 启 
动 系统 。 在 创建 的 任务 中 进行 CPU 使 用 率 计算 前 的 初始 化 ， 这 样 就 能 满足 条 件 。 即 使 这 样 做 ,仍然 会 有 系统 任务 ， 比 如 时 钟 节拍 任务 ,会 霸占 CPU 造 
成 一 些 误差 。 








函数 OSsstatTaskCPUUsagelnit 的 代码 见 代 码 清单 17-1。 


代码 清单 17-1 CPU 使 用 率 初始 化 函数 OSstatTaskCPUUsagelnit 





























1 void 0OSStatTaskCPUUsageInit (OS ERR *p err) 

“| 

3 OS ERR err; 

4 OS TICK dly; 

3 CPU SR ALLOC(); 

6 

7 

8 

9 #ifdef OS SAFETY CRITICAL 

10 if (p err == (OS ERR *)0) { 

1 OS_SAFETY CRITICAL EXCEPTION(); 

2 return; 

3 } 

4 #endif 

5 

6 OsTimeDly ( (OS_TICK )2, // 使 用 之 前 先 延 时 两 个 节拍 ， 是 为 了 后 面 的 延 时 更 准确 
可 (OS OPT )OS OPT TIME DLY, 

8 (OS_ERR *) &err); 

9 if (err != OS ERR NONE) { 

20 “pp err 三 -SEE 

21 return; 

22 } 

23 CPU CRITICAL ENTER(); 

24 OSStatTaskCtr = (OS TICK)O0; 

25 CPU_ CRITICAL EXIT(); 

26 

237 gly = (O08. TICK)'O0; 

28 if (OSCfg TickRate Hz > OSCfg StatTaskRate Hz) { 
29 dly = (OS TICK) (OSCfg TickRate Hz / OSCfg StatTaskRate Hz); 
30 } // 计算 出 要 延 时 的 节拍 数 

31 if (dly == (OS TICK)O0) { 

32 dly = (OS TICK) (OSCfg TickRate Hz / (OS RATE HZ)10); 
33 } 

34 

35 OsTimeDly (dly, 

36 OS_OPT TIME 











DE 
37 &err); /7 延 时 计算 好 的 节拍 数 ， 剥 村 当 前 运行 任务 的 CPU 使 用 权 


38 CPU _ CRITICAL ENTER(); 


39 OSStatTaskTimeMax = (CPU TS)0; 

40 

41 OsstatTaskCtrMax = OSStatTaskCtr; // 延 时 结 来， 更 新 0SStatTaskCtrMax 的 值 
42 OsstatTaskRdy = OS_STATE RDY; // 更 新 统计 任务 运行 状态 

43 CPU _ CRITICAL EXIT (); 

44 “OGLE = OS_ ERR NONE; 

45 } 


HC/OS-llI 采 用 调用 延 时 函数 的 方式 来 剥夺 当前 任务 的 CPU 的 使 用 权 ， 为 了 延 时 得 更 准确 ， 还 在 延 时 之 前 先 延 时 两 个 节拍 ， 如 图 17-3 所 示 。 先 延 
时 两 个 节拍 ， 再 继续 延 时 就 可 以 尽量 接近 要 延 时 的 节拍 数 。 





延 时 两 个 节拍 再 继续 延 | | 经 过 开 姑 的 延 时 后 继 
时 ， 实 际 上 只 有 1 个 多 | | 续 延 时 ， 这 时 就 接近 
1 要 延 时 的 节拍 数 


i 








[2 
(AD 


noses 


节拍 数 


某 个 时 刻 任务 ” 延 时 两 个 延 时 结束 
开始 延 时 节拍 结束 


图 17-3 ”时 钟 节拍 误差 分 析 





第 28~30 行 就 是 根据 时 钟 节拍 的 频率 和 统计 任务 设 定 的 频率 来 进行 计算 得 到 需要 延 时 的 节拍 数 。 


第 31~33 行 就 是 处 理 统 计 任 务 的 指向 频率 大 于 时 钟 节拍 频率 的 情况 。 


17.4 “堆栈 检测 过 程 简 介 


任务 切换 的 时 候 我 们 已 经 详细 讲解 了 堆栈 的 知识 ， 知 道 系统 运行 时 堆栈 对 一 个 任务 来 说 至 关 重 要 。 堆 栈 保存 了 任务 运行 过 程 中 需要 保存 局 部 变 
量 、 寄 存 器 等 重要 的 信息 。 如 果 设 置 的 堆栈 太 小 ， 任 务 不 能 正常 运行 ， 则 可 能 会 出 现 很 多 奇怪 的 错误 。 程 序 运 行 过 程 中 如 果 出 现 奇怪 的 错误 ， 那 么 排 
除 其 他 的 干扰 后 一 定 要 检查 堆栈 ， 包 括 MSP 的 堆栈 、 系 统 任务 的 堆栈 、 用 户 任务 的 堆栈 。 有 了 之 前 讲解 的 基础 ， 现 在 理解 堆栈 检测 的 原理 也 是 很 简单 
的 。hC/OS- 员 是 如 何 检测 任务 使 用 多 少 堆栈 的 呢 ? 以 堆栈 增长 方式 从 高 到 低 为 例 ， 如 图 17-4 所 示 ， 在 任务 初始 化 的 时 候 先 将 所 有 的 堆栈 都 置 0， 使 用 
后 的 堆栈 不 为 0， 检 测 时 只 需 从 堆栈 的 低地 址 开始 将 为 0 的 内 存 进 行 计数 ， 由 计算 即 可 得 出 使 用 了 多 少 堆 栈 ， 从 而 可 以 调整 任务 堆栈 的 大 小 。 这 些 信 息 
同样 也 会 在 统计 任务 每 隔 1/OSCfg_StatTaskRate_Hz 秒 就 进行 更 新 。 
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图 17-4 ”堆栈 检测 示意 图 





17.5 ”堆栈 检测 


函数 OSTaskStkChk 可 以 用 来 进行 堆栈 检测 。 如 果 用 户 将 宏 OS_CFG_STAT_TASK_STK_CHK_EN 和 OS_CFG_DBG EN 定义 为 1， 就 不 需要 自己 调 
用 这 个 函数 。 统 计 任 务 会 以 我 们 设 定 的 频率 不 断 更 新 堆栈 到 任务 控制 块 元 素 StkFree 和 StkUsed。 这 两 个 元 素 用 于 分 别 存放 剩 下 的 任务 堆栈 大 小 和 已 
使 用 的 任务 堆栈 大 小 ， 单 位 和 CPU 堆栈 数据 类 型 一 样 ， 如 STM32 就 是 4 个 字 节 。 如 果 只 是 检测 其 中 一 两 个 任务 的 堆栈 使 用 情况 ， 就 不 用 设置 
OS_CFG_STAT_TASK_STK_CHK_EN 和 OS_CFG_DBG_EN 的 值 为 1， 只 需 调 用 这 个 函数 即 可 。 注 意 函 数 创建 的 时 候 还 必须 允许 进行 堆栈 检测 ， 即 opt 
必须 为 OS OPT TASK_STK_CHK+OS OPT TASK _STK_CLR。OS OPT_ TASK_STK_CLR 会 在 任务 创建 的 时 候 将 堆栈 清 零 ， 这 也 是 检测 堆栈 必须 的 步 
又 之 一 。 运 行 的 时 间 要 足够 久 ， 也 就 是 说 ， 要 让 堆栈 的 使 用 情况 达到 极致 ， 才 可 以 检测 出 正确 的 数目 。 函 数 OsTaskChk 的 代码 如 代码 清单 17-2 所 
示 。 

参数 如 下 。 

1) p_tcb: 指向 任务 控制 块 的 指针 。 注 意 这 个 参数 可 以 是 空 指针 ， 当 这 个 参数 为 空 指针 时 ， 函 数 会 检测 当前 正在 运行 的 任务 的 堆栈 情况 。 

2) p_free: 指向 剩 下 任务 堆栈 大 小 的 指针 ， 一 般 将 要 检测 的 任务 指向 任务 控制 块 元 素 StkFree。 


3) p_used: 指向 已 用 任务 堆栈 大 小 的 指针 ， 一 般 将 要 检测 的 任务 指向 任务 控制 块 元 素 StkUsed。 


4) p_err: 指向 返回 错误 类 型 的 指针 ， 主 要 有 以 下 几 种 类 型 。 


. OS_ERR_NONE: 程序 运行 时 没有 出 现 错误 。 


" OS_ERR_PTR_INVALID: 参数 p_free 或 p_used 之 一 为 空 指针 。 


* OS_ERR_TASK_NOT_EXIST: 任务 堆栈 指针 ， 即 任务 控制 块 元 素 StkPtt 为 空 指针 。 


:. OS_ERR_TASK_OPT: 创建 任务 的 时 候 没 有 设置 选项 OS_OPT_TASK_STK_CHK。 


代码 清单 17-2 是 函数 OSTaskStkChk 的 源码 。 


代码 清单 17-2 ”任务 堆栈 检测 函数 OSTaskStkChk 
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#if OS CFG STAT TASK STK CHK EN > 0u 

void OSTaskStkChk (OS TCB we: tely 
CPU STK SIZE *p free, 
CPU STK SIZE *p used, 
OS ERR *p err) 





CPU STK SIZE free stk; 
CPU_STK *p_stk; 
CPU SR ALLOC(); 


#ifdef OS SAFETY CRITICAL 
if (p err == (OS ERR *)0) { 
OS_SAFETY CRITICAL EXCEPTION(); 


return; 





} 
#endif 


#if OS CFG CALLED FROM ISR CHK EN > 0u // 不 能 在 中 断 中 调用 函数 
if (OSIntNestingCtr > (OS NESTING CTR) 0) { 
*p err = OS ERR TASK STK CHK ISR; 
return; 








} 
#endif 


#if OS CFG ARG CHK EN > 0u // 检测 参数 是 否 合 法 ， 即 是 否 为 空 指针 
if (p free == (CPU STK SIZE*)0) { 
*p err = OS ERR PTR INVALID; 

return; 





} 


if (p used == (CPU STK SIZE*)0) { 
*p err = OS ERR PTR INVALID; 
Teturn: 








} 
#endif 


CPU _ CRITICAL ENTER(); // 进入 临界 段 

if fp tcb 一 (OS TCB *)0) { // 若 检 测 到 参数 p tcb 为 空 指针 ， 就 检测 当前 任务 
Pp tcb = OSTCBCurPtr; 

} 


if (p tcb->StkPtr == (CPU STK*)0) { // 检测 任务 的 堆栈 指针 是 否 为 空 指针 
CEU_ CRITICAL EXIT () ; // 退出 临界 区 
*p free = (CEU STK SIZE)O0; 
*p_used (CPU _STK SIZE)O; 
*p err OS_ERR TASK NOT EXIST; // 返回 错误 
return; 


} 

// 检测 任务 创建 时 输入 的 参数 选项 

if ((p tcb->Opt & OS OPT TASK STK CHK) == (OS OPT)0) { 
CPU CRITICAL EXIT(); 7/ 退出 临界 区 
xP free = (CPU STK SIZE)O; 
*p_used (CPU_ STK SIZE) 07 
*p_err OS_ ERR TASK OPT; // 返回 错误 
return; 


} 
CPU_ CRITICAL EXIT(); // 退出 临界 区 


free stk = Ou; 

#if CPU CFG STK GROWTH == CPU_STK GROWTH HI TO LO // 判断 堆栈 增长 方向 
p_stk = p tcb->StkBasePtr; // 堆栈 向 下 增长 从 低 处 开始 找 内 容 为 非 零 的 堆栈 空间 
while (*p stk =— (CPU STK)0) { 

Bb Stktts 
free stk+tt+; 


J 
#else // 堆栈 向 上 增长 从 高 处 开始 找 内 容 为 非 零 的 堆栈 空间 
p stk = p tcb->StkBasePtr + p tcb->StkSize - lu; 
while (*p stk == (CPU STK)0) { 
free stkt+tt+; 
区 





} 
#engdif 
“ES 
*p used 
*p_err 


free stk; 
(P_tcb->StkSize - free stk); // 更 新 已 经 使 用 的 堆栈 大 小 
OS_ERR NONE; 


78 } 
79 #enqif 





堆栈 检测 的 过 程 很 简单 ， 首 先 判断 堆栈 增长 的 方向 ， 以 STM32 为 例 ， 堆 栈 的 增长 方向 是 从 高 到 低 ， 那 么 我 们 应 该 从 最 低 的 地 址 开始 ， 直 到 找到 
有 非 零 的 堆栈 为 止 ， 一 边 找 一 边 计数 ， 最 后 得 到 的 值 就 是 未 使 用 的 内 存 的 量 。 


17.6 实例 解读 推 枝 洛 出 


堆栈 溢出 后 ， 程 序 出 栈 跟 入 栈 都 是 在 其 他 未 经 允许 的 内 存 上 进行 的 ， 随 意 修改 革 块 内 存 上 的 值 会 带 来 意 想不到 的 后 果 。 堆 栈 溢 出 这 个 问题 ， 在 使 
用 hC/OS- 员 等 Os 的 过 程 中 迟早 会 碰 到 。 堆 栈 溢 出 常常 会 导致 很 恐怖 的 结果 ， 令 写 程序 的 人 调试 程序 时 泪 流 满面 。 为 了 读者 能 够 更 好 地 对 待 堆 栈 溢 
出 ， 本 节 将 向 读者 讲解 一 个 笔者 由 堆栈 溢出 导致 的 “实验 事故 ”。 


注意 : 学 习 本 节 需 要 了 解 前 面 章节 和 Cortex-M3 的 相关 知识 
现象 : 程序 跑 飞 。 
工具 : 一 款 MDK 编 译 和 调试 软件 、 一 台 JLink 仿 真 器 、 开 发 板 一 块 。 


程序 运行 起 来 后 ， 使 用 儿 Link 来 进行 硬件 仿真 。 注 意 ， 硬 件 仿真 之 前 要 设置 程序 的 优化 等 级 为 最 低 ， 因 为 调试 过 程 需要 研究 对 应 的 汇编 程序 ， 若 
优化 程序 比较 高 ， 则 比较 难 找到 C 语 句 对 应 的 汇编 语句 。 M DK 设置 的 过 程 如 图 17-5 所 示 。 


全 速 运行 后 发 现 程序 进入 硬 fault， 要 找到 进入 异常 之 前 的 语句 ， 根 据 Cortex-M3 的 知识 ， 进 入 异常 之 前 的 PC 放 在 LR 中 。 这 时 如 果 直 接 查看 LR 的 
值 ， 说 明 前 面 的 知识 掌握 不 够 牢固 。 进 入 异常 后 LR 的 值 被 修改 成 EXC_RETURN 的 值 ， 原 来 的 LR 的 值 已 经 被 压 进 栈 了 。 我 们 要 根据 压 栈 的 顺序 从 SP 反 
推 到 LR 被 压 到 堆栈 的 那个 地 方 ( 压 栈 的 顺序 前 面 已 经 讲 过 ) 。 这 时 粗心 的 读者 可 能 又 想 直 接 找到 SP 寄存 器 进行 反 推 ， 前 面 我 们 讲解 过 在 uC/OS-lll 异 
常 中 使 用 的 是 MSP， 任 务 中 使 用 的 是 PSP， 因 此 现在 的 SP 是 MSP， 而 不 是 PSP， 必 须要 找到 PSP 进 行 反 推 。 首 先 在 进入 异常 最 前 面 的 地 方 设置 断 点 ， 
如 图 17-6 所 示 。 
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图 17-5 MDK 设 置 优化 等 级 为 最 低 





66: while (1) 
67: { 
68: } 





PEEEEELEEE 


0x09090309 
Ox10101010 
Ox11111111 
Dx04040404 


N 
oo | 3. 接着 查看 堆栈 指针 PSP | None 
Du08001596 
Ox610Dpp 部 yoid HardFault_Handler (void) 


Hendler 
Privileged 
MSP 


16496598 








SeAarching for_ ‘OSTaarCreAate'... 








图 17-6 ”调试 步骤 
找到 PSP 后 ， 要 反 推 出 LR 的 值 ， 这 时 要 调 出 内 存 窗口 以 观察 堆栈 PSP 前 几 个 内 存 的 内 容 ， 具 体 步 又 如 图 17-7 所 示 。 


调 出 内 存 窗口 后 输入 堆栈 指针 PSP 的 值 0X200009E8 即 可 找到 附近 地 址 的 内 容 ， 如 图 17-8 所 示 ， 根 据 寄 存 器 入 栈 顺 序 和 堆栈 增长 的 方向 可 以 推出 
LR 寄存 器 的 内 容 就 是 其 中 的 0x08004C37。 这 里 的 最 低位 置 1 同样 表示 的 是 thumb 状 态 下 执行 的 意思 ， 实 际 的 指令 是 0x08004C36。 


全 
本 
于] 


TEEEEITED 





* @brief This function handles Hard Fault exception. 
* @param None 
* @retval None 
*/ 
TT void HardFault_ Handler (void) 


HardFault :Ox%x”, (*(volatile unsigned int *)OQxE000ED2C)); 
用 法 Fault:0x%x”, (*(volatile unsigned int *)0xE000ED2A)).; 
存储 器 管理 Fault:0x%x”, (*(volatile unsigned int #)0xE000ED28) ) : 
总 线 Fault:0x%x”, (*(volatile unsigned int *)OxE000ED29)):; 


/* Go to infinite loop when Hard Fault exception occurs */ 


人 (1) 





Searchiny for_ ‘OSTaskCreate' ... 
Show or hide the Memory 1 Window 








图 17-7 调 出 内 存 窗口 











Address: [hc2000093E8 四 天 
0x200009E8: 20000848 PSP4 
0x200009EC: 00000001 
Ox200009F0: 200012E8 
0x200009F4: 00000000 
0x200009F8: 04040404 
0x200009FC 
0x20000A00: 08004B4A 
0x20000A04: 61000000 | 
0x20000A08: 00000000 | 


ca Ee = IT 一 上 3 We 








图 17-8 ”寄存 器 入 栈 内 存 内 容 


在 汇编 窗口 找到 地 址 为 0x08004C36 的 指令 ， 如 果 在 这 里 设置 断 点 ， 全 速 运行 ， 程 序 还 是 会 进入 异常 ， 这 是 由 于 CPU 流水 线 等 ， 涉 及 的 内 容 比 较 
深 。 这 给 我 们 真正 定位 让 程序 触发 异常 的 语句 带 来 困难 。 但 是 我 们 知道 所 要 找 的 语句 通常 就 在 这 条 语句 的 附近 ， 通 过 进一步 的 硬件 仿真 ， 似 乎 找到 了 
一 些 问题 ， 如 图 17-9 所 示 ， 在 0x08004B40 处 的 汇编 ，STR r2,[r1,#0xB0]， 意 思 是 将 寄存 器 R2 的 内 容 赋 给 地 址 为 R1+0xB0 的 内 存 ， 可 是 R1 的 值 在 运 
行 到 这 里 的 时 候 居然 是 1， 而 0XB1 在 STM32 中 就 是 代码 段 的 地 址 。 


结合 汇编 代码 上 面 的 语句 可 以 知道 R1 保 存 的 是 p_tcb_next， 即 p_tcb->DbgNextPtr， 这 是 在 删除 任务 Task_Start 时 调用 的 。 这 里 的 p_tcb 指 向 的 
就 是 任务 控制 块 StartUp_TCB 的 指针 。 也 就 是 说 ， 存 放任 务 控 制 块 StartUp_TCB 在 调试 列表 中 的 下 一 个 任务 控制 块 的 地 址 的 变量 StartUp_TCB- 
>DbgNextPtr 居 然 是 |。 地 址 为 1 处 是 向 量 表 的 开始 ! 我 们 可 以 猜测 内 存 (&StartUp_TCB) ->DbgNextPtr 的 值 可 能 被 自 改 了 ， 接 着 就 要 找到 哪里 修 
改 了 这 个 地 址 的 内 容 。 首 先 使 用 C 语 言语 句 printf ( mn%x” ,& ((&StartUp_TCB) ->DbgNextPtr) ) ;可 以 串口 打印 出 这 个 地 址 ， 显 示 为 
0X200008FC。 这 时 只 要 注意 观察 在 任务 创建 后 哪个 函数 把 这 块 内 存 的 内 容 进 行 了 修改 即 可 ， 同 时 打开 内 存 窗口 进行 单 步调 试 。 我 们 发 现在 任务 创建 
后 的 这 个 值 是 0x20003440， 而 在 map 文 件 中 查找 到 的 是 任务 控制 块 OSStatTaskTCB 的 地 址 。 这 是 很 正常 的 ， 在 运行 GUI_Init 函 数 之 后 ， 这 个 值 就 被 
算 改 成 1! 因为 这 个 函数 是 ST 公 司 用 来 初始 化 GUI 的 。 已 经 编译 成 库 ， 我 们 只 负责 调用 ， 一 般 不 会 有 问题 ， 出 了 问题 也 不 知道 具体 的 代码 。 这 时 可 以 
怀疑 是 任务 Task_start 发 生 了 堆栈 溢出 。 接 下 来 就 可 以 进行 验证 。 首 先 将 任务 Task_start 的 堆栈 尽量 调 大 ， 发 现 程序 正常 运行 ， 内 存在 运行 GUIL_Init 
函数 之 后 也 没有 发 现 被 修改 的 现象 。 接 着 在 GUI_lInit 函 数 之 后 调用 堆栈 检测 函数 OSTaskSstkChk， 发 现 堆栈 的 使 用 达到 了 102， 而 之 前 设置 的 堆栈 大 
小 是 80! 堆栈 在 溢出 之 后 一 直 在 进行 入 栈 操作 ， 把 后 面 的 内 存 做 了 修改 。 在 map 文 件 中 查看 StartUp_TCB 的 地 址 为 0x20000848， 大 小 为 192 个 字 
节 ， 任 务 堆栈 的 低地 址 为 0x20000908， 也 就 是 说 ，0x20000848~0x20000907 这 段 内 存 都 是 任务 控制 块 StartUp_TCB 的 ， 堆 栈 溢出 时 SP 一 路 “ 横 冲 
直 撞 ”直接 修改 了 任务 控制 块 StartUp_TCB 里 的 内 容 。 


523: OS TaskDbgListRemove (p tcb); 
524; #endif 


国 ， 





S259. OSTaskQty--; 





* Call user defined hook 


/* One less task being managed 


0S_ TaskInitTCB(p tcb); /* Initialize the TCB to default values 
p_tcb->TaskState = (0S_ STATE)0S_TASK_STATE_DEL : /* Indicate that the task was deleted 


OS_CRITICAL EXIT_NO_SCHED() : 
De head . 


/* Find now hirhos+ nriority +aclr 


轩 





图 17-9 ”定位 异常 程序 


本 节 介 绍 的 调试 内 容 还 是 不 容易 的 ， 尤 其 要 在 LR 寄 存 器 的 指令 附近 查找 到 异常 的 指令 。 虽 然 本 节 剖析 了 堆栈 溢出 的 相关 知识 ， 但 是 读者 干 万 不 能 
以 为 自 此 可 以 运筹 肉 由 ， 应 当 更 加 小 心 ， 从 调试 结果 来 看 ， 堆 栈 溢 出 具有 潜伏 期 。 从 GUIL_Init 函 数 的 堆栈 溢出 到 最 后 的 删除 任务 的 时 候 程序 才 出 现 错 
误 ， 并 且 这 些 错误 可 能 都 是 一 些 奇 怪 的 现象 ， 大 部 分 会 触发 异常 。 堆 栈 溢出 就 像 一 个 小 偷 ， 将 内 存单 元 上 的 内 容 偷梁换柱 ， 当 程序 真正 要 用 到 这 块 内 
存 内 容 的 时 候 ， 就 将 这 个 已 经 被 偷 换 过 的 内 容 直 接 拿 去 使 用 ， 毫 不 知情 ， 后 果 自 然 是 不 可 预料 的 。 在 茫茫 内 存 中 发 生 这 样 的 错误 ， 是 多 么 恐怖 的 事 
情 。 


17.7 ”统计 任务 OS_StatTask 


代码 清单 17-3 是 统计 任务 OS_StatTask 的 具体 代码 。 


代码 清单 17-3 ”统计 任务 OS_StatTask 








1 void OS StatTask (void *p arg) 

2 1{ 

3 #if OS CFG DBG EN > 0u 

4 #if OS CFG TASK PROFILE EN > 0u 

5 OS CPU USAGE usage; 

6 OS_CYCLES cycles total; 

7 #engif 

8 OS_TCB *p tcb; 

9 #enqif 
4140 OS_ERR err; 
11 OS_TICK dly; 
12 CPU_TS ts_start; 
13 CPU_TS ts_end; 
14 CPU SR ALLOC(); 
15 
16 

1. parg = p arg; 

18 // 0SStatTaskRdqy 只 有 在 OSStatTaskCPUUsageInit 函 数 之 后 才 置 1， 和 否则 一 直 延 时 
19 while (OSStatTaskRdy != DEF TRUE) { 
20 OSTimeDly (2u * OSCfg ， StatTaskRate Hy 
2 OS_OPT TIME DLY, 
22 &err); 
23 } 
24 OSStatReset (&err) ;// 正式 开始 统计 任务 之 前 重 置 统计 信息 
25 
26 dly = (0S_ TICK)O; 
a 让 (OSCfg ， TickRate Hz > OSCfg StatTaskRate Hz) { 
28 dly = (OS TICK) (OSCfg ， TickRate Hz / OSCfg StatTaskRate Hz); 
29 } 

30 if (dly = (OS TICK) 0) { 

下 dly = (OS TICK) (OSCfg TickRate Hz / (OS RATE HZ)10) 





32 }// 根据 设置 的 宏 计算 统 计 任务 的 执行 频率 。 











34 while (DEF ON) { 

35 ts_ start = 0S_TS_GET();// 统计 任务 执行 前 先 获取 时 间 玲 ， 
36 #ifdef CPU CFG INT DIS MEAS EN // 获取 稍 大 关中 断 时 间 

37 OSIntDisTimeMax = CPU IntDisMeasMaxGet (); 

38 #endif 

39 

40 CPU_CRITICAL ENTER(); 

41 OsstatTaskCtrRun = OSstatTaskCtr; 

42 OSsStatTaskCtr = (OS TICK)O; 

43 CPU _ CRITICAL EXIT(); 

44 

45 if (OSStatTaskCtrMax > OSStatTaskCtrRun) { 

46 if (OSStatTaskCtrMax > (OS TICK)0) { 

47 OSStatTaskCPUUsage = (OS CPU USAGE) ( (OS TICK)100u - 100u * OSStatTaskCtrRun / OSStatTaskCtrMax); 
48 } else { 

49 OSStatTaskCPUUsage = (OS _ CPU USAGE)100; 
Ss0 } 

与 二 } else { 

52 OSStatTaskCPUUsage = (OS _ CPU USAGE)100; 

53 } 

54 

55 OSStatTaskHook (); 

56 

57 


58 #if OS _ CFG DBG EN > 0u 
59 #if OS CFG TASK PROFILE EN > Ou 

















60 cycles total = (OS CYCLES)O0; 

61 

62 p tcb = OSTaskDbgListPtr; 

63 while (p tcb != (OS TCB *)0) { 

64 OS CRITICAL ,ENTER (); 

65 Be tcb->CyclesTotalPrev = p tcb->CyclesTotal; 
66 p_ tcb->CyclesTotal = (OS _ CYCLES) 07 

67 OS_CRITICAL EXIT(); 

68 

69 cycles total += p tcb->CyclesTotalPrev; 
70 

71 pteb = p tcb->DbgNextpPtr; 
2 

73 #enqif 

74 

75 

76 #if OS CFG TASK PROFILE EN > 0u 

了 7 cycles total /= 100u; 

78 #endif 

79 p tcb = OSTaskDbgListPtr; 

80 while (p tcb != (OS TCB *)0) { 

81 #if OS CFG TASK PROFILE EN > 0u 

82 if (cycles _ total > (0OS_CYCLES)0) { 

83 usage = (OS _ CPU | USAGE) (p_ tcb->CyclesTotalPrev / cycles total); 
84 if (usage > 100u) { 

85 usage = 100u; 

86 } 

87 } else { 

88 usage = 0u; 

89 } 

90 

1 p_tcb->CPUUsage = usage; 

92 #engif 


93 // 对 每 个 任务 进行 堆栈 检测 ， 将 检测 堆栈 的 结果 放 在 任务 控制 块 元 素 StkFree 和 StkUsed 中 
94 #if OS CFG STAT TASK STK CHK EN > 0u 








95 OSTaskStkChk( p tcb, 
96 &p_ tcb->StkFree, 
97 &p tcb->StkUsed, 
98 &err); 
99 #engif 
100 // 检测 下 一 个 
101 Pp tcb = p tcb->DbgNextPptr; 
102 } 
103 #engif 
104 // 查看 初始 化 好 了 没有 ， 如 果 想 对 统计 信息 进行 重 置 ， 简 单 的 做 法 就 是 置 
// OSStatResetFlag 为 DEF FALSE, 在 这 里 2 
105 if (OSStatResetFlag == DEF TRUE) { 
106 OSstatResetFlag = DEF FALSE; 
107 OSStatReset (&err); 
108 } 
109 // 计算 统计 任务 每 次 使 用 了 多 长 时 间 ， 更 新 在 变量 OSStatTaskTimeMax 中 
110 ts end = OS TS GET() - ts start; 
111 if (ts end > OSStatTaskTimeMax) { 
和 2 OSStatTaskTimeMax = ts end; 
4113 } 
114 // 根据 前 面 计算 好 的 dly 延 时 一 段 时 间 ， 以 执行 统计 任务 周期 。 
115 OsTimeDly (dly, 
116 OS_OPT TIME DLY, 
TL &err); 
118 } 
119 } 








统计 任务 主要 按照 一 定 的 频率 更 新 系统 总 的 CPU 使 用 率 、 各 个 任务 占用 CPU 的 使 用 率 、 任 务 堆栈 已 使 用 堆栈 、 最 大 关中 断 时 间 等 统计 量 。 注 意 任 
务 开始 之 前 要 先 调 用 OSSstatTaskCPUUsagelnit 进 行 初 始 化， 不然 所 有 的 信息 都 不 会 得 到 更 新 ， 任 务 被 系统 的 延 时 函数 进行 了 阻塞 。 


1 7 8 总 结 





本 章 讲 解 了 CPU 使 用 率 的 计算 和 堆栈 使 用 检测 这 两 个 统计 信息 的 计算 过 程 。 


测量 CPU 使 用 率 之 前 的 1s 让 一 个 变量 一 直 做 加 法 ， 这 个 加 法 放 在 空闲 任务 当中 。 当 CPU 正式 开始 运行 的 时 候 ， 同 样 时 间 内 变量 加 法 的 结果 就 没有 
一 直 加 那么 大 ， 因 为 运行 其 他 任务 要 占用 CPU， 不 是 一 直 在 空闲 任务 中 。 根 据 这 些 关 系 和 最 后 加 法 的 结果 可 以 计算 出 CPU 的 使 用 率 。 





第 18 章 nC/OS-lll 在 不 同 CPU 上 的 移植 


将 移植 这 部 分 内 容 放 在 最 后 讲解 主要 是 因为 要 对 uC/OS-lll 有 比较 深 的 了 解 ， 以 及 要 对 CPU 比 较 熟 悉 ， 很 多 地 方 要 根据 CPU 手 册 进 行 编写 。 本 章 
介绍 移植 的 时 候 ， 也 只 是 简单 介绍 移植 部 分 的 原理 ， 因 为 大 部 分 原理 已 在 前 面 讲解 源码 的 时 候 介绍 过 。HC/OS- 川 官方 网 站 (micrium.com) 已 经 有 
很 多 移植 到 不 同 CPU 的 工程 ， 用 户 可 以 直接 下 载 使 用 。 在 各 大 电子 论坛 上 虽然 经 常 有 人 发 一 些 所 谓 的 移植 教程 ， 但 是 通过 查看 其 内 容 可 发 现 只 是 将 官 
方 已 经 移植 好 的 例 程 进行 修改 ， 比 如 从 IAR 编 译 器 的 例 程 修改 到 可 以 在 MDK 编 译 器 上 运行 ， 准 确 地 说 ， 这 不 叫 移植 。 所 谓 移植 ， 指 的 是 通过 修改 
HC/OS- 员 部 分 与 CPU 相关 的 文件 ， 让 hC/OS-I 可 以 在 不 同 的 CPU 上 运行 。 





本 章 编写 的 流程 主要 按照 JC/OS-lll 的 文件 层次 来 进行 ， 首 先 讲解 移植 接口 相关 的 文件 ， 接 着 介绍 CPU 相 关 的 文件 ， 最 后 介绍 配置 相关 文件 。 


18.1 移植 接口 主要 文件 编写 


18.1.1 os_cpu_c.c 文 件 


移植 路 上 第 一 只 拦路 虎 就 是 函数 
CPU _STK*OSTaskstklnit (OS_ TASK_PTRPp task,void*p arg,CPU_STK*p _stk_base,CPU STK*p stk limitCPU_STK_ SIZEstk_ size,OS OPTopt) 。 
这 个 函数 前 面 已 经 介绍 过 ， 其 主要 功能 就 是 初始 化 任务 的 堆栈 ， 让 任务 的 堆栈 看 起 来 就 像 刚 发 生 过 中 断 ， 以 方便 第 一 次 任务 切换 的 时 候 将 堆栈 弹出 ， 
开始 运行 任务 。OSTaskstklnit 的 参数 有 以 下 几 个 ， 编 写 函 数 的 时 候 要 严格 按照 函数 的 这 几 个 参数 进行 编写 。 


1) p_task: 任务 代码 的 指针 。 

2) p_arg: 任务 的 输入 参数 。 

3) p_stk_base: 堆栈 的 最 低地 址 ， 注 意 不 是 堆栈 的 开始 地 址 。 

4) p_stk_limit: 任务 堆栈 的 限制 。 

5) stk_size: 堆栈 的 大 小 ， 堆 栈 的 单位 是 前 面 读者 定义 的 CPU_STK_SIZE 的 数据 类 型 。 
6) opt: 附加 选项 。 


另外 还 要 注意 几 个 问题 ， 此 函数 是 模拟 将 寄存 器 的 内 容 放 入 任务 栈 ， 要 严格 按照 CPU 入 栈 的 顺序 将 寄存 器 的 内 容 依次 放 入 任务 栈 中 。 那 么 寄存 器 
的 内 容 有 没有 要 求 呢 ? 肯定 有 ， 内 容 放 好 后 ， 只 有 任务 将 堆栈 的 内 容 弹出 来 才 可 以 正确 执行 。 首 先 最 重要 的 是 PC，PC 是 指向 CPU 执行 内 容 的 地 址 ， 
第 一 次 将 任务 的 堆栈 弹出 来 后 要 执行 任务 ， 这 时 就 要 将 任务 的 入 口 地 址 给 PC， 即 参数 p_task， 并 对 应 到 PC 在 入 栈 的 顺序 ， 再 将 其 按照 这 个 顺序 放 入 
堆栈 中 。 接 着 将 任务 传递 的 参数 放 入 CPU 调用 函数 时 寄存 器 对 应 的 任务 栈 中 的 位 置 ，CPU 调 用 参数 一 般 放 在 CPU 的 RO0、R1、R2、R3 这 几 个 寄存 器 或 
堆栈 中 ， 有 具体 情况 要 根据 CPU 而 定 。 比 如 Cortex-M3 调 用 堆栈 的 情况 就 是 “ 子 程 序 依次 将 参数 彻底 给 寄存 器 RO~ R3” ， 而 51 则 是 将 传递 的 参数 放 入 
堆栈 中 。 这 个 过 程 也 要 注意 堆栈 的 增长 方向 ， 如 果 堆 栈 的 增长 方向 是 从 低 到 高 ， 那 么 模拟 入 栈 的 时 候 将 p_stk_base 依 次 递增 即 可 ; 但 是 ， 如 果 堆 栈 的 
增长 方向 是 从 高 到 低 ， 则 堆栈 要 从 地 址 &p_stk_base[stk _size-1] 开 始 ， 每 入 栈 一 个 寄存 器 ， 就 要 相应 地 减 去 相应 的 偏 移 量 。 任 务 通常 是 不 可 以 返回 
的 ， 若 万 一 用 户 写 了 不 是 无 限 循环 的 任务 ， 即 可 以 返回 ， 将 发 现 不 可 预料 的 后 果 ， 这 在 一 些 CPU 中 取决 于 寄存 器 LR， 即 连接 寄存 器 的 内 容 。 我 们 可 以 











将 这 个 寄存 器 对 应 在 堆栈 中 的 顺序 记 下 ， 然 后 将 任务 堆栈 的 这 个 地 方 设置 为 09_TaskReturn ， 这 是 一 个 无 限 循环 函数 的 入 口 地址 。 


OS CPU_sysTickHandler 是 时 钟 节拍 中 断 服 务 程序 ， 主 要 在 其 调用 hC/OS- 员 编写 好 的 函数 OSTimeTick 进 行 整个 系统 的 时 间 管 理 。 
OS_CPU_sysTickHandler 主 要 内 容 如 代码 清单 18-1 所 示 ， 所 有 CPU 都 是 按照 以 下 方式 进行 编写 的 。 


代码 清单 18-1 时钟 节 拍 中 断 服务 程序 ODS CPU_sysTickHandler 








1. OS CPU SysTickHandler 

2 

3 OSIntEnter (); // 用 于 统计 中 断 的 骨 套 层 数 ， 对 谋 套 层 数 +1 

4 OSTimeTick (); // 统计 时 间 ， 遍 历任 务 ， 对 延 时 任务 计时 减 1 
5 OSIntExit () ， // 对 峰 套 层 数 减 1， 在 退出 中 断 前 启动 任务 调度 
6. } 


函数 OS_ CPU_SysTicklnit 用 于 初始 化 时 钟 节拍 中 断 ， 可 用 于 初始 化 中 断 的 优先 级 ， 中 断 的 使 能 等 ， 这 个 函数 要 根据 不 同 的 CPU 进行 编写 ， 并 且 
在 系统 任务 的 第 一 个 任务 开始 的 时 候 进行 调用 。 如 果 在 此 之 前 进行 调用 ， 则 可 能 会 造成 系统 崩溃 ， 因 为 系统 还 没有 初始 化 好 就 进入 中 断 ， 可 能 在 进入 
和 退出 中 断 的 时 候 会 调用 系统 未 初始 化 好 的 一 些 模块 。 


18.2 ”编写 CPU 相关 文件 


18.2.1 cpu_c.c 文 件 和 cpu_a.asm 文 件 


这 个 文件 主要 是 CPU 底层 相关 的 一 些 CPU 函 数 ， 用 户 可 以 自行 添加 。cpu_c.c 文 件 存放 的 是 C 函 数 ，cpu_a.asm 文 件 存放 的 是 汇编 函数 。 两 个 文件 
必须 要 编写 的 函数 是 CPU_IntEn 和 CPU _lIntDis， 分 别 用 来 开关 中 断 ， 采 用 汇编 还 是 C 语 言 的 方式 编写 存放 在 cpu_c.c 或 者 cpu_a.asm。 


18.3 ”编写 配置 文件 


18.3.1 os app_app.h 文 件 


在 这 个 文件 中 ， 读 者 可 以 自行 修改 相关 的 宏 来 修改 系统 的 设置 ， 比 如 定时 器 的 执行 频率 、 时 钟 节拍 的 频率 等 。 


18.4 忆 结 


本 章 从 系统 移植 相关 的 各 个 文件 说 起 ， 按 照 移植 接口 、CPU、 配 置 的 顺序 介绍 了 文件 中 应 该 编写 和 修改 的 内 容 ， 读 者 可 以 参考 官方 网 站 上 已 经 移 
植 好 的 其 他 CPU 的 工程 进行 修改 。 


